POST /api/v1/admin/cache
Emergency cache flush. Invalidates cached offers, qualification rules, and/or contact policies. Admin only.
Request Body
| Field | Type | Required | Description |
|---|
scope | string | No | "all", "offers", "qualificationRule", or "contactPolicy". Default: "all" |
Response
{
"success": true,
"flushed": "all",
"tenantId": "tenant_001",
"timestamp": "2026-03-16T14:30:00.000Z"
}
GET /api/v1/admin/dlq
Get dead letter queue (DLQ) summary and events. Admin only.
Query Parameters
| Parameter | Type | Default | Description |
|---|
limit | integer | 50 | Max events to return (max 200) |
topic | string | — | Filter by topic |
Response
{
"totalEvents": 15,
"byTopic": {
"interaction_events": 10,
"pipeline_runs": 5
},
"events": [
{
"id": "dle_001",
"topic": "interaction_events",
"payload": { "customerId": "CUST001" },
"error": "Timeout after 30000ms",
"retryCount": 3,
"failedAt": "2026-03-16T12:00:00.000Z"
}
],
"alert": "WARNING"
}
Alert Levels
| Level | Condition |
|---|
OK | 10 or fewer events |
WARNING | 11-100 events |
CRITICAL | More than 100 events |
POST /api/v1/admin/dlq
Retry or purge DLQ events. Admin only.
Request Body
| Field | Type | Required | Description |
|---|
action | string | Yes | "retry" or "purge" |
eventIds | string[] | No | Specific event IDs to process |
topic | string | No | Process all events for a topic |
Response (retry)
{
"action": "retry",
"requeued": 10
}
Response (purge)
{
"action": "purge",
"deleted": 15
}
GET /api/v1/admin/retention-configs
List data retention configurations for the tenant. Admin only.
Response
[
{ "id": "rc_001", "dataClass": "interactions", "retentionDays": 365, "legalHold": false },
{ "id": "rc_002", "dataClass": "decisions", "retentionDays": 90, "legalHold": false },
{ "id": "rc_003", "dataClass": "audit", "retentionDays": 2555, "legalHold": true }
]
POST /api/v1/admin/retention-configs
Create or update a retention configuration (upsert). Admin only.
Request Body
| Field | Type | Required | Description |
|---|
dataClass | string | Yes | "interactions", "decisions", "metrics", or "audit" |
retentionDays | integer | Yes | Retention period in days (1-36500) |
legalHold | boolean | No | When true, data is exempt from automatic cleanup |
Example
curl -X POST https://playground.kaireonai.com/api/v1/admin/retention-configs \
-H "Content-Type: application/json" \
-H "X-Tenant-Id: my-tenant" \
-d '{
"dataClass": "interactions",
"retentionDays": 365,
"legalHold": false
}'
200 OK
POST /api/v1/cleanup
Trigger data cleanup for expired variant assignments and old audit logs. Rate limited to 5 requests per 60 seconds. Admin only.
Response
{
"cleaned": {
"expiredVariantAssignments": 1200,
"oldAuditLogs": 5000
}
}
GET /api/v1/metrics/summary
Returns Prometheus kaireon_* metrics as JSON. Used by the operations dashboard. Admin only.
Response
{
"kaireon_recommend_requests_total": {
"name": "kaireon_recommend_requests_total",
"type": "counter",
"values": [{ "labels": {}, "value": 152000 }]
},
"kaireon_recommend_latency_seconds": {
"name": "kaireon_recommend_latency_seconds",
"type": "histogram",
"values": [{ "labels": { "le": "0.1" }, "value": 140000 }]
}
}
POST /api/v1/tenant/reset
Reset a playground workspace by deleting all tenant data. Only available for playground tenants. Admin only.
Request Body
| Field | Type | Required | Description |
|---|
confirm | boolean | Yes | Must be true to proceed |
Response
{
"message": "Workspace reset successfully. Decision counter is back to 0."
}
This permanently deletes ALL tenant data including Offers, Decision Flows, pipelines, interaction history, and all other records. This cannot be undone.
Roles
| Endpoint | Allowed Roles |
|---|
POST /admin/cache | admin |
GET /admin/dlq | admin |
POST /admin/dlq | admin |
GET /admin/retention-configs | admin |
POST /admin/retention-configs | admin |
POST /cleanup | admin |
GET /metrics/summary | admin |
POST /tenant/reset | admin |
