agent-sessions

Get Conversation Detail

Get 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:

{
  "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}
    }
  ]
}

GET

agents

{agent_id}

conversations

{conversation_id}

Get Conversation Detail

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

{
  "conversation_id": "<string>",
  "agent_id": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "messages": [
    {
      "role": "<string>",
      "content": "<string>",
      "timestamp": "<string>",
      "metadata": {}
    }
  ],
  "metadata": {}
}

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

conversation_id

string

required

Response

Successful Response

Full conversation with all messages.

conversation_id

string

required

agent_id

string

required

created_at

string

required

updated_at

string

required

messages

Message · object[]

required

Show child attributes

metadata

Metadata · object

Delete ConversationDelete a conversation and all its messages. Use this to: - Remove sensitive conversations - Clean up test data - Comply with data deletion requests Warning: This action is irreversible.

Get Conversation Detail

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

{
  "conversation_id": "<string>",
  "agent_id": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "messages": [
    {
      "role": "<string>",
      "content": "<string>",
      "timestamp": "<string>",
      "metadata": {}
    }
  ],
  "metadata": {}
}

Documentation Index

Authorizations

Path Parameters

Response