Skip to main content
GET
Read an approval 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).

Response

OK

One gate as the inbox lists it.

action_id
string
required

The action it gates.

action_name
string
required

The verb it wants.

blast_radius
string
required

How far the consequences reach.

created_at
string<date-time>
required

When it was raised.

detail
string
required

The resolver's note, empty while pending.

expires_at
string<date-time>
required

When it stops waiting.

fleet_id
string
required

The fleet that raised it.

fleet_name
string
required

That fleet's name, joined at read time so a rename is visible.

gate_id
string
required

The gate's own row id — what a decision addresses it by.

gate_type
string
required

Which family of gate this is.

proposed_action
string
required

What the fleet proposes, in a person's words.

resolved_by
string
required

Who resolved it, empty while pending.

resolved_by_name
string
required

Resolver's display name, or an empty string when unavailable. Fall back to resolved_by when empty.

status
string
required

Where the gate stands.

tool_name
string
required

The tool asking.

workspace_id
string
required

The workspace it belongs to.

evidence
object | null

The evidence behind the proposal, verbatim.

resolved_at
string<date-time> | null

When it was resolved, or null while pending.