Skip to main content
GET
List pending approvals
Returns actions that a guardrail rule stopped and handed to a person, oldest first. Nothing in this list has run. Approvals raised through the API have no screen of their own — that is deliberate. The people who decide (“is this refund fine?”) work in your product, not in the CoreBase panel, so you render these where they already are. Poll this endpoint after a completion comes back saying it is waiting for approval. 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

Authorization
string
header
required

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

Query Parameters

project_id
string | null

List approvals in this project. Omit for the default project.

Response

Successful Response

id
string
required

Approval id — pass it to the decide endpoint.

chat_id
string
required

The conversation the action belongs to.

tool
string
required

The action the assistant tried to take.

source
string | null

Data source the action targets.

rule
string | null

Name of the rule that held it.

arguments
Arguments · object

Exactly what will run if you approve. Show this to whoever decides.

requested_at
string | null

When the action was held (ISO 8601, UTC).