Skip to main content

Submit client-side tool execution results

POST 
/api/v1/llm/submit-client-tool-results

Submits results for client-side tool calls and returns without waiting for the next generation segment. While the conversation still identifies a run, workflow validation rejects unmatched calls with 400 and already-resolved calls with 410.

If no active run is recorded, this call can succeed without applying any results. Reconcile stored run and tool state before treating HTTP success as confirmation that the results were applied.

A run can request further batches. Read pending client tools, execute each new batch and submit its results until the run reaches a terminal outcome. An unknown status requires reconciliation with a bounded wait, not an assumption of success. See Messages and run outcomes for outcome handling and the synchronous client-tool loop.

Request​

Responses​

Client tool results submitted

Document ID: DOC-MA-conversations-api-submitClientToolResults. Section identities and revisions.

SectionStable reference
OverviewDOC-MA-conversations-api-submitClientToolResults#overview
RequestDOC-MA-conversations-api-submitClientToolResults#request
ResponsesDOC-MA-conversations-api-submitClientToolResults#responses