Skip to main content

Conversation History And Audit

Use these endpoints to list conversations, fetch history, and retrieve audit logs.

List Conversations For An Agent​

GET /api/v1/agents/:slug/conversations

Get Conversation By ID​

GET /api/v1/agents/:slug/conversations/:id

Get Conversation History​

GET /api/v1/agents/:slug/conversations/:id/history

Response example:

{
  "id": "uuid",
  "agent_id": "uuid",
  "capability_id": "uuid",
  "user_id": "external-user-id",
  "status": "active",
  "outcome": null,
  "turns": [
    {"role": "user", "message": "Hello", "timestamp": "2026-02-01T10:00:00Z"},
    {"role": "agent", "message": "Hi!", "timestamp": "2026-02-01T10:00:01Z"}
  ],
  "created_at": "2026-02-01T10:00:00Z",
  "updated_at": "2026-02-01T10:00:01Z",
  "completed_at": null
}

Get Audit Logs​

GET /api/v1/agents/:slug/conversations/:id/audit-logs

Audit logs include routing decisions, action calls, and timing metadata. They are the accountability layer behind Supervised Intelligence.

Headers​

All endpoints require:

tenant-id: your-tenant-id