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

project_idstringformat: "uuid"

thread_model_idstringformat: "uuid"

start_timedatetime

end_timedatetime

durationdouble

first_messagemap from strings to any or list of objects or string

last_messagemap from strings to any or list of objects or string

feedback_scoreslist of objects

statusenum

Allowed values:

number_of_messageslong

total_estimated_costdouble

usagemap from strings to longs

commentslist of objects

tagslist of strings

last_updated_atdatetime

last_updated_bystring

created_bystring

created_atdatetime

Errors

404

Not Found Error