dots.approvals.byApproval_id().post()
Generated on 18 Nov 2026
from DoTs version
v1.25.0
Usage
client.approvals.byApproval_id(approval_id).post(body: Approval_decision, requestConfiguration?: RequestConfiguration<object>): Promise<undefined | Approval_decision_response>Description
Approves or denies a tool call that is waiting for approval, identifying the session with the X-Session-Id header or the endpoint with the X-Endpoint-Id header. With X-Session-Id, it behaves the same as POST /approvals/session/{session_id}/{approval_id}, which is the path returned in a result’s _meta.decide. An unknown X-Endpoint-Id returns 404.
Parameters
Path Parameters
approval_idstring requiredExample:
7d3c2b1a-9e8f-4a6b-8c5d-4e3f2a1b0c9dThe
approval_idfrom a tool result whose_meta.statusisrequires_approval.
Headers
X-Session-Idstring optionalExample:
2b3c9f0e-1a4d-4e5f-8a7b-6c5d4e3f2a1bThe session to act in: the UUID at the end of the session's
sessionUrnandmcpUrl. For a pinned endpoint version, use the session UUID at the end of itsmcp_url, not the composite version ID. The session must belong to the authenticated user and team. Send either this header orX-Endpoint-Id, not both; both returns 400. With neither, the request uses your default endpoint when default endpoints are enabled for your team, and otherwise returns 403.X-Endpoint-Idstring optionalExample:
1b4d4e0f-9a7c-4d5b-8f3c-2a6e6e8f0a13The endpoint to act in, as a lowercase endpoint UUID. The request uses the endpoint's current head version, which the response reports in
X-Action-Gateway-Endpoint-Version. The endpoint must belong to the authenticated user and team; an unknown or inaccessible endpoint returns 404. Send either this header orX-Session-Id, not both. A malformed value or more than one value returns 400.X-Actor-Idstring optionalExample:
aliceThe actor you expect the session or endpoint to be bound to. It does not select an actor or connections; those come from the session's or endpoint's
actor_id. When sent, it must equal that binding. A different value, including any value for a target with no actor, returns 403 with the message "The session is not bound to the request's actor."
Request Body
decisionstring requiredWhether to let the pending call run.
Request Sample
Response Example
More Information
See /approvals/{approval_id} in the API reference for additional detail on responses, headers, parameters, and more.