Approvals API: Approve or Deny Agent Requests - OneCLI

When a grant or rule marks a tool as needing approval, the gateway holds the agent’s request until someone decides. These endpoints let your own tool or bot receive those requests and answer them. Long-poll for pending requests, then approve to forward the request or deny to block it. For what triggers an approval, see Rules and Agent access.

Endpoints

Endpoint	Method and path	What it does
List pending approvals	`GET /approvals/pending`	Long-poll for manual-approval requests waiting in your workspace.
Submit an approval decision	`POST /approvals/{id}/decision`	Approve or deny a held manual-approval request.

Next steps

API overview: base URLs, authentication, and pagination
Errors: status codes and the error format
Editions: which endpoints each edition serves