Get trace threads | Opik Documentation

curl http://localhost:5173/api/v1/private/traces/threads \
     -H "Content-Type: application/json"

{
  "page": 1,
  "size": 1,
  "total": 1,
  "content": [
    {
      "id": "a3f1c9d2-4b7e-4f9a-9c3d-2e5b7f8a1c2d",
      "project_id": "d9f8e7c6-b5a4-4321-9f8e-7d6c5b4a3f2e",
      "thread_model_id": "b1c2d3e4-f5a6-7890-b1c2-d3e4f5a67890",
      "start_time": "2024-01-15T09:30:00Z",
      "end_time": "2024-01-15T09:45:30Z",
      "duration": 930,
      "first_message": [
        "User: How do I improve model accuracy?",
        "System: Please provide your dataset details."
      ],
      "last_message": [
        "User: Thanks, the suggestions helped!",
        "System: Glad to assist you."
      ],
      "feedback_scores": [
        {
          "name": "User Satisfaction",
          "value": 8.5,
          "source": "ui",
          "category_name": "Engagement",
          "reason": "Positive user feedback",
          "created_at": "2024-01-15T09:50:00Z",
          "last_updated_at": "2024-01-15T09:55:00Z",
          "created_by": "jane.doe@example.com",
          "last_updated_by": "jane.doe@example.com",
          "value_by_author": {
            "jane.doe@example.com": {
              "value": 8.5,
              "reason": "User rated helpfulness",
              "category_name": "Engagement",
              "source": "ui",
              "last_updated_at": "2024-01-15T09:55:00Z",
              "span_type": "message",
              "span_id": "msg-12345"
            }
          }
        }
      ],
      "status": "active",
      "number_of_messages": 12,
      "total_estimated_cost": 0.023,
      "usage": {
        "tokens": 350,
        "api_calls": 1
      },
      "comments": [
        {
          "text": "Thread shows good user engagement and quick response times.",
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "created_at": "2024-01-15T10:00:00Z",
          "last_updated_at": "2024-01-15T10:05:00Z",
          "created_by": "admin@example.com",
          "last_updated_by": "admin@example.com"
        }
      ],
      "tags": [
        "model-improvement",
        "user-feedback"
      ],
      "last_updated_at": "2024-01-15T10:05:00Z",
      "last_updated_by": "admin@example.com",
      "created_by": "jane.doe@example.com",
      "created_at": "2024-01-15T09:30:00Z"
    }
  ],
  "sortableBy": [
    "start_time",
    "end_time",
    "duration",
    "number_of_messages",
    "total_estimated_cost"
  ]
}

Get trace threads

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

project_namestringOptional

project_idstringOptionalformat: "uuid"

truncatebooleanOptionalDefaults to false

strip_attachmentsbooleanOptionalDefaults to false

filtersstringOptional

sortingstringOptional

searchstringOptional

from_timedatetimeOptional

to_timedatetimeOptional

Response

Trace threads resource

pageinteger

sizeinteger

totallong

contentlist of objects

sortableBylist of strings