agent-sessions

List Agent Conversations

List all conversation sessions for an agent.

Returns a paginated list of conversations with summary information. Use this to:

View conversation history
Audit agent interactions
Find specific conversations
Track agent usage

Example response:

{
  "sessions": [
    {
      "conversation_id": "conv-123",
      "created_at": "2025-11-25T10:00:00Z",
      "updated_at": "2025-11-25T10:05:00Z",
      "message_count": 12,
      "last_message_preview": "Thank you for your help!"
    }
  ],
  "total": 45,
  "limit": 10,
  "offset": 0
}

GET

agents

{agent_id}

conversations

List Agent Conversations

curl --request GET \
  --url https://api.example.com/agents/{agent_id}/conversations \
  --header 'Authorization: Bearer <token>'

{
  "sessions": [
    {
      "conversation_id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "message_count": 123,
      "last_message_preview": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string<uuid>

required

Query Parameters

limit

integer

default:10

Number of sessions to return

Required range: 1 <= x <= 100

offset

integer

default:0

Offset for pagination

Required range: x >= 0

Response

Successful Response

List of conversation sessions.

sessions

SessionSummary · object[]

required

Show child attributes

total

integer

required

limit

integer

required

offset

integer

required

Get Conversation DetailGet full conversation history with all messages. Returns complete conversation transcript including: - All user messages - All agent responses - Tool executions - Timestamps - Metadata Use this for: - Reviewing agent performance - Debugging conversations - Customer service audits - Training data collection Example response: ```json { "conversation_id": "conv-123", "agent_id": "agent-456", "created_at": "2025-11-25T10:00:00Z", "updated_at": "2025-11-25T10:05:00Z", "messages": [ { "role": "user", "content": "What is your refund policy?", "timestamp": "2025-11-25T10:00:00Z" }, { "role": "assistant", "content": "Our refund policy...", "timestamp": "2025-11-25T10:00:02Z", "metadata": {"selected_tool": null, "execution_time_ms": 850} } ] } ```

List Agent Conversations

curl --request GET \
  --url https://api.example.com/agents/{agent_id}/conversations \
  --header 'Authorization: Bearer <token>'

{
  "sessions": [
    {
      "conversation_id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "message_count": 123,
      "last_message_preview": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Documentation Index

Authorizations

Path Parameters

Query Parameters

Response