v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB

fleet threads

Create a thread

Create a thread, optionally bound to an agent. Subsequent runs are started on it via POST /v1/fleet/threads/{thread_id}/runs/stream.

post/v1/fleet/threads

agent_idstring

if_exists'do_nothing' | 'raise'

metadataobject

thread_idstring uuid

{
  "agent_id": "11111111-1111-1111-1111-111111111111"
}

Created

agent_idstring uuid

created_atstring date-time

idstring uuid

metadataobject

status'idle' | 'busy' | 'interrupted' | 'error'

updated_atstring date-time