Skip to main content
POST
Threads Query Stream

Corps

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
requis

The ID of the project

Exemple:

"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'.

Exemple:

Réponse

Stream of data in JSONL format

thread_id
string
requis
turn_count
integer
requis

Number of turn calls in this thread

start_time
string<date-time>
requis

Earliest start time of turn calls in this thread

last_updated
string<date-time>
requis

Latest end time of turn calls in this thread

first_turn_id
string | null
requis

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

last_turn_id
string | null
requis

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

p50_turn_duration_ms
number | null
requis

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

p99_turn_duration_ms
number | null
requis

99th percentile of turn durations in milliseconds within this thread

Dernière modification le 30 septembre 2026