Get a get conversation conversations conversation ID

Get details of a specific conversation.

GET /conversations/{conversation_id}

cURL

curl --request GET \
  --url 'http://localhost:8000/conversations/{conversation_id}' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "messages": [
    {}
  ],
  "created_at": "2026-08-31T14:22:05Z",
  "last_message_at": "2026-08-31T14:22:05Z",
  "total_tokens": 1,
  "metadata": {}
}

Get details of a specific conversation.

Path parameters

conversation_id · string · required

Response

object

conversation_id · string · required

agent_id · string · required

messages · object[] · required

created_at · string (date-time)

last_message_at · string (date-time)

total_tokens · integer

metadata · object

Status codes

Code	Meaning
200	Successful response
401	Authentication required
404	Conversation not found
422	Validation Error
429	Rate limit exceeded

cURL

curl --request GET \
  --url 'http://localhost:8000/conversations/{conversation_id}' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY"

200

{
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "messages": [
    {}
  ],
  "created_at": "2026-08-31T14:22:05Z",
  "last_message_at": "2026-08-31T14:22:05Z",
  "total_tokens": 1,
  "metadata": {}
}