Skip to main content
POST
Approve or reject a pending request

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

Path Parameters

workspace_id
string
required

Workspace identifier (version 7 universally unique identifier, or UUID).

gate_id
string
required

Approval gate identifier (version 7 universally unique identifier, or UUID).

decision
string
required

What to do with the gate: approve or deny.

Body

application/json

The body a decision may carry.

Every field is optional, and so is the whole body. A decision is complete without a note, and demanding one would make the common answer the awkward one.

reason
string | null

The operator's note, stored as the gate's detail.

Response

OK

What answering a gate reports, whether or not this caller won the race.

action_id
string
required

The action it gated.

gate_id
string
required

The gate that was answered.

outcome
string
required

Where it now stands.

resolved_at
string<date-time>
required

When it was decided.

resolved_by
string
required

Who decided it — not necessarily this caller.