Get trace thread | Opik Documentation

curl -X POST http://localhost:5173/api/v1/private/traces/threads/retrieve \
     -H "Content-Type: application/json" \
     -d '{
  "thread_id": "thread-9f8b7c6d5e4a3b2c1d0e"
}'

{
  "id": "thread-9f8b7c6d5e4a3b2c1d0e",
  "project_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "thread_model_id": "7e4a1b2c-3d4f-5a6b-7c8d-9e0f1a2b3c4d",
  "start_time": "2024-01-15T09:30:00Z",
  "end_time": "2024-01-15T09:45:00Z",
  "duration": 900,
  "first_message": {},
  "last_message": {},
  "feedback_scores": [
    {
      "name": "Response Accuracy",
      "value": 95.5,
      "source": "ui",
      "category_name": "Quality",
      "reason": "High relevance to query",
      "created_at": "2024-01-15T09:35:00Z",
      "last_updated_at": "2024-01-15T09:40:00Z",
      "created_by": "user123",
      "last_updated_by": "user123",
      "value_by_author": {}
    }
  ],
  "status": "active",
  "number_of_messages": 12,
  "total_estimated_cost": 0.023,
  "usage": {},
  "comments": [
    {
      "text": "Initial analysis looks promising.",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "created_at": "2024-01-15T09:32:00Z",
      "last_updated_at": "2024-01-15T09:33:00Z",
      "created_by": "analyst_jane",
      "last_updated_by": "analyst_jane"
    }
  ],
  "tags": [
    "urgent",
    "model-v1.2"
  ],
  "last_updated_at": "2024-01-15T09:45:00Z",
  "last_updated_by": "analyst_jane",
  "created_by": "system_bot",
  "created_at": "2024-01-15T09:30:00Z"
}

Get trace thread

Request

This endpoint expects an object.

thread_idstringRequired>=1 character

project_namestringOptional

project_idstringOptionalformat: "uuid"

truncatebooleanOptional

Response

Trace thread resource

idstring or null

project_idstring or nullformat: "uuid"

thread_model_idstring or nullformat: "uuid"

start_timedatetime or null

end_timedatetime or null

durationdouble or null

first_messagemap from strings to any or list of objects or string or null

last_messagemap from strings to any or list of objects or string or null

feedback_scoreslist of objects or null

statusenum or null

Allowed values:

number_of_messageslong or null

total_estimated_costdouble or null

usagemap from strings to longs or null

commentslist of objects or null

tagslist of strings or null

last_updated_atdatetime or null

last_updated_bystring or null

created_bystring or null

created_atdatetime or null

Request

Response

Errors