Skip to main content
POST
Threads Query Stream

본문

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
필수

The ID of the project

예시:

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

예시:

응답

Stream of data in JSONL format

thread_id
string
필수
turn_count
integer
필수

Number of turn calls in this thread

start_time
string<date-time>
필수

Earliest start time of turn calls in this thread

last_updated
string<date-time>
필수

Latest end time of turn calls in this thread

first_turn_id
string | null
필수

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

last_turn_id
string | null
필수

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

p50_turn_duration_ms
number | null
필수

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

p99_turn_duration_ms
number | null
필수

99th percentile of turn durations in milliseconds within this thread

마지막 수정일 2026년 9월 30일