Skip to main content
GET
List threads

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Query Parameters

project_id
string | null

Filter by project (account) id

Pattern: ^[0-9a-fA-F]{24}$
user_id
string | null

Filter by end-user id

external_id
string | null

Filter by caller-supplied external id

created
string[] | null

RFC3339 timestamp(s); two values = a [start, end] range

tool
string[] | null

Filter by activated tool code(s)

rule
string[] | null

Rule 'code', or 'code:fired|blocked|passed'

param
string[] | null

'key:value', 'key:*', or 'key' with >,<,>=,<=

agent_id
string[] | null

Filter by agent id(s)

Pattern: ^[0-9a-fA-F]{24}$
runtime_version
string
default:1

Runtime generation to list threads from: '1' (the default) lists threads of agents on the v1 runtime — today's behavior; any other value (e.g. '2' or '0.5.4') lists runtime-v2 threads, which requires an agent_id or user_id filter.

page[size]
integer
default:50
Required range: 1 <= x <= 100
page[after]
string | null
page[before]
string | null
sort_by
string
default:created_at
sort_order
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful Response

results
ThreadListItem · object[]
required
meta
PageMeta · object
required