Join Run

curl --request GET \
  --url https://api.example.com/threads/{thread_id}/runs/{run_id}/join

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Thread Runs

Join Run

Wait for a run to complete and return its output.

Returns a chunked application/json response. While the run is still executing, the server sends periodic \n heartbeat bytes to keep the connection alive through proxies and load balancers (AWS ALB, Cloudflare, etc.). The final chunk is the JSON result. Leading whitespace is ignored by JSON parsers, so clients can parse the concatenated body normally.

If the run is already in a terminal state, the output is returned immediately with no heartbeat overhead.

Sessions are managed manually (not via Depends) to avoid holding a pool connection during the long wait.

GET

threads

{thread_id}

runs

{run_id}

join

Join Run

curl --request GET \
  --url https://api.example.com/threads/{thread_id}/runs/{run_id}/join

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Path Parameters

thread_id

string

required

run_id

string

required

Response

Successful Response

Update Run Wait For Run

⌘I

Health

Assistants

Threads

Thread Runs

Stateless Runs

Store

Join Run

Path Parameters

Response