List pending approvals
Lists actions waiting on a human decision, oldest first.
Approvals raised through this API have no screen of their own — render them
in your product, where the people who decide already work. Poll this
endpoint after a completion comes back saying it is waiting for approval.
Requests older than 24 hours are no longer decidable and stop appearing
here. Requires the mcp_query permission.
arguments is exactly what will run if you approve. Show it to whoever decides:
approving binds the decision to these values, not to whatever the assistant
would generate on a later turn.
Requests stop appearing here 24 hours after they were raised — after that they
can no longer be decided, and the assistant has to ask again.
See Guardrails for how a rule decides that an action
needs approval in the first place.Authorizations
A cb_live_ API token, created in the panel under API Tokens.
Query Parameters
List approvals in this project. Omit for the default project.
Response
Successful Response
Approval id — pass it to the decide endpoint.
The conversation the action belongs to.
The action the assistant tried to take.
Data source the action targets.
Name of the rule that held it.
Exactly what will run if you approve. Show this to whoever decides.
When the action was held (ISO 8601, UTC).