Skip to main content
POST
Threads Query Stream

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

Example:

"my_entity/my_project"

filter
ThreadsQueryFilter · object | null

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:

Response

Stream of data in JSONL format

thread_id
string
required
turn_count
integer
required

Number of turn calls in this thread

start_time
string<date-time>
required

Earliest start time of turn calls in this thread

last_updated
string<date-time>
required

Latest end time of turn calls in this thread

first_turn_id
string | null
required

Turn ID of the first turn in this thread (earliest start_time)

last_turn_id
string | null
required

Turn ID of the latest turn in this thread (latest end_time)

p50_turn_duration_ms
number | null
required

50th percentile (median) of turn durations in milliseconds within this thread

p99_turn_duration_ms
number | null
required

99th percentile of turn durations in milliseconds within this thread