Skip to main content
GET
Get a single approval gate by id

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

gate_id
string
required

UUIDv7 of the approval gate.

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
integer<int64>
required

When it was raised.

detail
string
required

The resolver's note, empty while pending.

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_kind
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

That person's display name, empty when this deployment holds no user row for the subject.

Sent so a client never has to ask an identity provider who a subject is. resolved_by stays the identifier of record; this is the label beside it, and a client that gets "" shows the subject itself.

status
string
required

Where the gate stands.

timeout_at
integer<int64>
required

When it stops waiting.

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.

updated_at
integer<int64> | null

When it was resolved, or null while pending.