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_id string required

Example: 7d3c2b1a-9e8f-4a6b-8c5d-4e3f2a1b0c9d

The approval_id from a tool result whose _meta.status is requires_approval.

Headers

X-Session-Id string optional

Example: 2b3c9f0e-1a4d-4e5f-8a7b-6c5d4e3f2a1b

The session to act in: the UUID at the end of the session's sessionUrn and mcpUrl. For a pinned endpoint version, use the session UUID at the end of its mcp_url, not the composite version ID. The session must belong to the authenticated user and team. Send either this header or X-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-Id string optional

Example: 1b4d4e0f-9a7c-4d5b-8f3c-2a6e6e8f0a13

The 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 or X-Session-Id, not both. A malformed value or more than one value returns 400.

X-Actor-Id string optional

Example: alice

The 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

decision string required

Whether to let the pending call run.

One of: approve, deny

Request Sample

Show Request Sample
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.approvals
    .byApproval_id("7d3c2b1a-9e8f-4a6b-8c5d-4e3f2a1b0c9d").post({
    decision: "deny",
});

Response Example

Show Response Example
{
  "id": "7d3c2b1a-9e8f-4a6b-8c5d-4e3f2a1b0c9d",
  "status": "denied",
  "expires_at": "2026-10-09T18:30:00Z"
}

More Information

See /approvals/{approval_id} in the API reference for additional detail on responses, headers, parameters, and more.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.