API referenceAgents and workflowsWorkflow runs
Approve or reject a parked approval gate
Requires the workflows:approve permission.
The human gate must stay human — deliberately NoMCP so the assistant can never approve a workflow's own approval step.
AuthorizationBearer <token>
An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.
In: header
Path Parameters
id*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/workflow-runs/string/approvals" \ -H "Content-Type: application/json" \ -d '{ "decision": "string", "step_id": "string" }'Empty