Skip to main content
POST
Approve or decline an action
Records a decision on an action a guardrail rule is holding. This endpoint does not run anything by itself. Approving marks the held call as allowed once; it executes on the conversation’s next completion, which is also where the assistant explains what happened. So after deciding, send that conversation another request — with no new user message if you have nothing to add:
Declining is final: the call never runs, and the assistant is told not to retry it or attempt it another way. A decision can only be made once, and only within 24 hours of the request. A second attempt returns 409.

Authorizations

Authorization
string
header
required

A cb_live_ API token, created in the panel under API Tokens.

Path Parameters

approval_id
string
required

Body

application/json

Approve or decline a held action.

decision
enum<string>
required

approve runs the held call; reject refuses it for good.

Available options:
approve,
reject

Response

Successful Response