Skip to main content
POST
Submit an approval decision
Records the decision for one pending request. Scope the call to the request’s workspace with a workspace API key or an X-Workspace-Id header. See Rules. Approve or deny a pending manual-approval request. Approving forwards the held request to its upstream service; denying blocks it. Scope the call to the request’s workspace with a workspace API key or an X-Workspace-Id header.
Availability: Cloud · Community (self-hosted) · Enterprise (self-hosted)
Served by the gateway, not the API server. The base URL is your gateway’s HTTP origin (https://gw.onecli.sh on Cloud; http://localhost:10255 self-hosted, or <app-url>/gw behind a reverse proxy). Read it from GET /gateway-url.

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

id
string
required

The approval ID from GET /approvals/pending.

Body

application/json
decision
enum<string>
required

Whether to forward the held request (approve) or block it (deny).

Available options:
approve,
deny

Response

Decision recorded and the held request released

success
boolean