Decide a tool approval
Approve or deny a held tool call as one of its approvers. You must be signed in yourself: API keys and calls on behalf of an end user are refused. The decision does not run the tool. The caller that made the request has 24 hours to continue its response with an approval response carrying the same decision, which runs an approved call once. Repeating your own decision returns the approval unchanged; a decision somebody else made, or one that differs from yours, answers 409 tool_approval_already_decided, and an approval past its deadline answers 409 tool_approval_expired.
Authorizations
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Headers
Optional external end-user identifier forwarded by the API gateway.
Path Parameters
The ID of the approval request item (mcpr_... or tapr_...).
1 - 255Body
Response
OK
A tool call held for approval. Approvals that name approvers stay listed for 30 days after they are decided or time out; the others are removed at their deadline.
The ID of the approval request item in the response output (mcpr_... or tapr_...).
The type of the approval request item: mcp_approval_request for an MCP call, tool_approval_request for a built-in tool.
mcp_approval_request, tool_approval_request pending until an approver decides, or, for an approval without approvers, until the caller's continuation answers it. expired when the deadline passed without a decision.
pending, approved, denied, expired The held tool's type: mcp, or a built-in tool type such as web_search or code_interpreter.
The name of the tool the model called.
MCP calls only: the label of the MCP server.
The arguments the call runs with if it is approved.
The response that stopped for this approval.
The saved agent the request ran for, if any.
Who made the request whose tool call was held. Only this caller can continue the response.
The users the organization's tool policy named to decide this call. Empty when the caller decides.
Who decided: the approver, or the caller for an approval without approvers.
The comment or reason given with the decision.
Whether the caller's continuation has consumed the decision. An approved call runs only when this happens, and only once.
When the call was held.
The deadline for the next step: the decision while pending, then the caller's continuation. A decision gives the caller 24 hours.
When the decision was made.