List threads
cURL
GET /management/v1/threads
Lists your organization’s threads, newest first, as a paginated
list. Filters OR within a field and
AND across fields — repeat a parameter to OR values:
string
Filter by project.
string
Filter by agent — repeatable.
string
Filter by end-user id.
string
RFC 3339 timestamp — repeat it twice for a
[start, end] range.string
Threads where this tool was activated — repeatable.
string
Threads where a rule was evaluated:
code, or code:outcome with outcome
one of fired, blocked, passed. Repeatable.string
Threads by computed parameter:
key:value, key:* (any value), or a
comparison like amount>100. Repeatable.string
Which agent runtime to list threads from. Omit for v1 agents (the default);
pass the runtime version your v2 agent runs on (e.g.
0.8.0) to list its
threads. v2 listings are always scoped — include an agent_id or user_id
filter — and only agent_id, user_id, and created (with agent_id)
apply there; v1-specific filters return a clear 400 on the v2 path.id, title, created_at, and version_tag
— the agent version the conversation ran on, so you can tell at a glance which
release of your agent handled it.
Get a thread
GET /management/v1/threads/{threadId}
Returns one thread — its title, the user_id it belongs to, its
welcome_message, and current followup_suggestions.
string
Required for threads of v2 agents (UUID thread ids): pass the runtime
version the agent runs on (e.g.
0.8.0). Omit for v1 threads. A thread
lives on the runtime that created it — asking the wrong one returns 404.
Applies to the rename and transcript endpoints below as well.Rename a thread
PATCH /management/v1/threads/{threadId}
cURL
string
The new title. Fields you omit are left unchanged; the full updated thread
is returned.