v48

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

Create a thread and start a run

Creates a thread bound to agent_id and starts a run on it in one call. Returns the upstream run record (pending/running, not yet complete). Run kwargs are passed through; thread-creation flags go in the optional thread envelope. The new thread is rolled back if the run fails to start.

post/v1/fleet/threads/runs

Request body

agent_idstring

Example request

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

Response

OK

object required