Skip to main content
GET
https://api.tracelm.ai
/
api
/
v1
/
conversations
/
{id}
Get Conversation
curl --request GET \
  --url https://api.tracelm.ai/api/v1/conversations/{id}
{
  "id": "<string>",
  "user_id": "<string>",
  "tasks": [
    {}
  ],
  "traces": [
    {}
  ],
  "context_failures": [
    {}
  ],
  "started_at": "<string>",
  "last_activity_at": "<string>"
}
Returns detailed information about a conversation including all associated tasks and traces.

​
Path Parameters

​
id
string
required
The conversation ID

​
Response

​
id
string
Unique conversation identifier
​
user_id
string
Associated user ID
​
tasks
array
Array of tasks in this conversation
​
traces
array
Array of all traces in this conversation
​
context_failures
array
Array of detected context failures
​
started_at
string
When the conversation started (ISO 8601)
​
last_activity_at
string
When the last activity occurred (ISO 8601)

​
Example

curl -X GET "https://api.tracelm.ai/api/v1/conversations/conv_456" \
  -H "X-API-Key: $TRACELM_API_KEY"

​
Response

{
  "id": "conv_456",
  "user_id": "user_123",
  "tasks": [
    {
      "id": "task_1",
      "task_name": "search_flights",
      "status": "completed",
      "started_at": "2024-01-15T10:00:00Z"
    },
    {
      "id": "task_2",
      "task_name": "book_flight",
      "status": "completed",
      "started_at": "2024-01-15T10:15:00Z"
    }
  ],
  "traces": [
    {
      "id": "trace_1",
      "task_id": "task_1",
      "model": "gpt-4o-mini",
      "created_at": "2024-01-15T10:00:05Z"
    }
  ],
  "context_failures": [
    {
      "type": "forgotten_preference",
      "severity": "medium",
      "description": "User's seat preference (window) was not applied",
      "trace_id": "trace_5"
    }
  ],
  "started_at": "2024-01-15T10:00:00Z",
  "last_activity_at": "2024-01-15T10:45:00Z"
}
Context failures are tracked across the entire conversation, helping identify when the agent forgets important user preferences or context from earlier in the session.