POST
/v1/threads/{thread_id}/runsRuns
Execute an Assistant against a Thread. Stream events or poll for completion.
Request
- HTTP
- POST
- URL
- /v1/threads/{thread_id}/runs
- Auth
- api_key
Try it
curl https://api.fightclub.pro/v1/threads/thread_abc/runs \
-H "Authorization: Bearer $FC_API_KEY" \
-d '{"assistant_id":"asst_xyz","stream":true}'Parameters
| Name | Type | Description |
|---|---|---|
| assistant_id* | string | Which assistant to run. |
| stream | boolean | Stream run events as SSE. |
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Run ID (run_*). |
| status | string | queued | in_progress | completed | failed | cancelled. |
Errors
- 401
invalid_api_key, Missing or revoked key. - 404
assistant_not_found, No such assistant.
See the full error reference.