v26

latestOpenAPI 3.1.0raw.githubusercontent.com2025-08-055185128.2 KB

run

Create Run Route

Creates a new run, starting it in the background.

post/api/threads/{thread_id}/runs/

Path parameters

thread_idstring uuid required

Request body

model'gpt-4o'

instructionsstring nullable

additional_instructionsstring nullable

knowledge_base_idstring uuid nullable

context_limitinteger nullable

The maximum number of context chunks to include.

codex_access_keystring nullable

codex_as_cacheboolean nullable

assistant_idstring uuid required

Response

Successful Response

model'gpt-4o'

instructionsstring nullable

additional_instructionsstring nullable

knowledge_base_idstring uuid nullable

context_limitinteger nullable

The maximum number of context chunks to include.

codex_access_keystring nullable

codex_as_cacheboolean nullable

thread_idstring uuid required

assistant_idstring uuid required

idstring uuid required

status'pending' | 'in_progress' | 'completed' | 'failed' | 'canceled' | 'expired' required

created_atstring date-time required

updated_atstring date-time required

deleted_atstring date-time nullable

last_errorstring nullable