Skip to main content
POST
/
threads
/
stream_query
[
  {}
]

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Query threads with aggregated statistics based on turn calls only.

Turn calls are the immediate children of thread contexts (where call.id == turn_id). This provides meaningful conversation-level statistics rather than including all nested implementation details.

​
project_id
string
required

The ID of the project

​
filter
ThreadsQueryFilter · object

Filter criteria for the threads query

​
limit
integer | null

Maximum number of threads to return

​
offset
integer | null

Number of threads to skip

​
sort_by
SortBy · object[] | null

Sorting criteria for the threads. Supported fields: 'thread_id', 'turn_count', 'start_time', 'last_updated', 'p50_turn_duration_ms', 'p99_turn_duration_ms'.

Example:
[
  {
    "direction": "desc",
    "field": "last_updated"
  }
]

Response

Stream of data in JSONL format