Skip to main content
POST

Request

deployment_id
string
required
Deployment ID to scope this thread to
metadata
object
User-defined metadata (e.g., user ID, session info)
values
object
Initial thread state values

Response

thread_id
string
Thread ID (e.g., thr_abc123xyz)
deployment_id
string
Deployment ID
status
string
Thread status: idle
metadata
object
User-defined metadata
created_at
string
ISO 8601 timestamp