API ReferenceConversations
Get Conversation
Get a specific conversation with its details.
Retrieve a single conversation by ID. Use embed=(messages) to include
the full message history with generation metadata (tokens, model, latency).
Path Parameters
conversation_id*string
Format
uuidQuery Parameters
embed?|
Embed resources: (messages)
Header Parameters
x-workspace-id?|
Workspace UUID to operate within. Required for session auth and user-scoped API keys. Optional for workspace-scoped API keys (uses key's workspace if omitted).
Response Body
application/json
application/json
curl -X GET "https://loading/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"external_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"message_count": 0,
"annotation_count": 0,
"messages": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"role": "string",
"parts": [
{}
],
"sequence_number": 0,
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"generation": {
"model": "string",
"input_tokens": 0,
"output_tokens": 0,
"cost_usd": 0,
"response_id": "string",
"provider": "string",
"finish_reasons": [
"string"
],
"agent_description": "string",
"agent_id": "string",
"agent_name": "string"
}
}
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}