Approve or reject pending tool calls

POST 
/api/v1/llm/submit-tool-approvals

Submits approval decisions for pending calls. An accepted approval permits the conversation workflow to continue subject to execution checks; it is not a general authorization grant. Rejection prevents dispatch of a still-pending call and does not undo an action already executed elsewhere.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Approve a tool action and finish the conversation · Event catalog

Request

Responses

200

Approvals submitted

Approve a pending tool call; use its ID from listPendingApprovals.

Section ID: DOC-MA-conversations-api-submitToolApprovals#example-conversations-submitToolApprovals-request

Request example

{
  "conversationKey": "example_123",
  "approvals": [
    {
      "toolCallId": "tool_call_123",
      "approved": true
    }
  ]
}

Guide request for Step 3: Submit the decision and inspect the outcome. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-submitToolApprovals#example-cookbook-managed-agents-delegation-approvals-using-tools-02-request

Request example

{
  "conversationKey": "support-chat-001",
  "approvals": [
    {
      "toolCallId": "call_abc123",
      "approved": true
    }
  ]
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-submitToolApprovals#example-conversations-submitToolApprovals-response

Response example

{}

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

Section	Stable reference
Approve or reject pending tool calls	DOC-MA-conversations-api-submitToolApprovals#overview
Request	DOC-MA-conversations-api-submitToolApprovals#request
Responses	DOC-MA-conversations-api-submitToolApprovals#responses