Skip to main content
POST
CSharp (SDK)

Authorizations

Authorization
string
header
required

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

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

approval_id
string
required

The ID of the approval request item (mcpr_... or tapr_...).

Required string length: 1 - 255

Body

application/json
decision
enum<string>
required

approve lets the caller's continuation run the call; deny lets it only record the denial.

Available options:
approve,
deny
comment
string

Why, shown to the requester and recorded in the audit ledger.

Maximum string length: 2000

Response

200 - application/json

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.

object
any
required
id
string
required

The ID of the approval request item in the response output (mcpr_... or tapr_...).

kind
enum<string>
required

The type of the approval request item: mcp_approval_request for an MCP call, tool_approval_request for a built-in tool.

Available options:
mcp_approval_request,
tool_approval_request
status
enum<string>
required

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.

Available options:
pending,
approved,
denied,
expired
tool_type
string
required

The held tool's type: mcp, or a built-in tool type such as web_search or code_interpreter.

tool_name
string
required

The name of the tool the model called.

server_label
string | null
required

MCP calls only: the label of the MCP server.

arguments
object
required

The arguments the call runs with if it is approved.

response_id
string
required

The response that stopped for this approval.

agent_id
string | null
required

The saved agent the request ran for, if any.

requested_by
Tool approval requester · object
required

Who made the request whose tool call was held. Only this caller can continue the response.

approver_user_ids
string[]
required

The users the organization's tool policy named to decide this call. Empty when the caller decides.

decided_by_user_id
string | null
required

Who decided: the approver, or the caller for an approval without approvers.

comment
string | null
required

The comment or reason given with the decision.

claimed
boolean
required

Whether the caller's continuation has consumed the decision. An approved call runs only when this happens, and only once.

created_at
string<date-time>
required

When the call was held.

expires_at
string<date-time>
required

The deadline for the next step: the decision while pending, then the caller's continuation. A decision gives the caller 24 hours.

decided_at
string<date-time> | null
required

When the decision was made.