List threads
List your organization’s conversation threads, newest first. Repeatable
filters (tool, rule, param, created) OR within a field and
AND across fields. runtime_version other than ‘1’ lists runtime-v2
threads instead — that engine’s threads are indexed per agent, so an
agent_id (or user_id) filter is required there.
Authorizations
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
Filter by project (account) id
^[0-9a-fA-F]{24}$Filter by end-user id
Filter by caller-supplied external id
RFC3339 timestamp(s); two values = a [start, end] range
Filter by activated tool code(s)
Rule 'code', or 'code:fired|blocked|passed'
'key:value', 'key:*', or 'key' with >,<,>=,<=
Filter by agent id(s)
^[0-9a-fA-F]{24}$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.
1 <= x <= 100asc, desc