Skip to main content
GET
Get a thread

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.

Path Parameters

threadId
string
required
Pattern: ^[0-9a-fA-F]{24}$|^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Query Parameters

runtime_version
string
default:1

Runtime generation the thread lives on: '1' (the default) reads threads of agents on the v1 runtime — today's behavior; any other value (e.g. '2' or '0.5.4') reads runtime-v2 threads.

Response

Successful Response

id
string
required

Thread id

Pattern: ^[0-9a-fA-F]{24}$|^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
title
string
required

Thread title

user_id
string | null

End-user this thread belongs to, if any

welcome_message
string | null

Agent's opening message

followup_suggestions
string[] | null

Suggested follow-up prompts