Threads

Submit Tool Outputs for a Run

Submit the outputs of tool calls that an assistant message previously requested. This will continue the run. If stream=true, returns a Server-Sent Events stream.

post/threads/{thread_id}/runs/{run_id}/submit-tool-outputs

Path parameters

thread_idstring uuid required

run_idstring required

Query parameters

streamboolean

Headers

authorizationstring nullable

x_session_tokenstring nullable

Request body

toolsobject[] nullable

Optional override for the assistant's tool list, applied only to this run. Each entry is an OpenAI-style tool definition (e.g. {type: 'function', function: {...}}).

Response

Successful Response

messagestring required

thread_idstring uuid required

run_idstring required

contentstring nullable

message_idstring uuid nullable

role'user' | 'assistant' | 'tool'

status'IN_PROGRESS' | 'REQUIRES_ACTION' | 'COMPLETED' | 'FAILED' | 'CANCELLED'

tool_callsobject[] nullable

memory_operation_idstring nullable

retrieved_filesstring[] nullable

retrieved_files_countinteger

reasoningstring nullable

model_providerstring nullable

model_namestring nullable

input_tokensinteger nullable

output_tokensinteger nullable

total_tokensinteger nullable

created_atstring date-time nullable

timestampstring date-time required

context_usageobject nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.