Get trace threads

GET

/v1/private/traces/threads

GET

/api/v1/private/traces/threads

curl http://localhost:5173/api/v1/private/traces/threads

200Retrieved

{
  "page": 1,
  "size": 1,
  "total": 1,
  "content": [
    {
      "id": "string",
      "project_id": "string",
      "thread_model_id": "string",
      "start_time": "2024-01-15T09:30:00Z",
      "end_time": "2024-01-15T09:30:00Z",
      "duration": 1.1,
      "first_message": {},
      "last_message": {},
      "feedback_scores": [
        {
          "name": "string",
          "value": 1.1,
          "source": "ui",
          "category_name": "string",
          "reason": "string",
          "source_queue_id": "string",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "string",
          "last_updated_by": "string",
          "value_by_author": {}
        }
      ],
      "status": "active",
      "number_of_messages": 1,
      "total_estimated_cost": 1.1,
      "usage": {},
      "comments": [
        {
          "text": "string",
          "id": "string",
          "source_queue_id": "string",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "string",
          "last_updated_by": "string"
        }
      ],
      "tags": [
        "string"
      ],
      "annotation_queues": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "last_updated_at": "2024-01-15T09:30:00Z",
      "last_updated_by": "string",
      "created_by": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "environment": "string"
    }
  ],
  "sortableBy": [
    "string"
  ]
}

Get trace threads

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

project_namestringOptional

project_idstringOptionalformat: "uuid"

truncatebooleanOptionalDefaults to false

Truncate input, output and metadata to slim payloads

strip_attachmentsbooleanOptionalDefaults to false

If true, returns attachment references like [file.png]; if false, downloads and reinjects stripped attachments

filtersstringOptional

sortingstringOptional

excludestringOptional

Enrichment fields to leave out of each thread, e.g. ["annotation_queues"]

searchstringOptional

Full-text search across thread fields

from_timedatetimeOptional

Filter trace threads created from this time (ISO-8601 format).

to_timedatetimeOptional

Filter trace threads created up to this time (ISO-8601 format). If not provided, defaults to current time. Must be after 'from_time'.

annotation_queue_idstringOptionalformat: "uuid"

Filter threads belonging to this annotation queue and scope feedback scores/comments to it

Response

Trace threads resource

pageintegerOptional

sizeintegerOptional

totallongOptional

contentlist of objectsOptional

sortableBylist of stringsOptional