Skip to main content
GET
Get a fleet

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.

fleet_id
string
required

UUIDv7 of the fleet.

Response

OK

GET /v1/workspaces/{workspace_id}/fleets/{fleet_id} — one fleet, whole.

The list row's fields plus the editable surface. Flattened rather than nested under a summary key, because that is the shape the source editor already reads.

budget_used_nanos
integer<int64>
required

Lifetime spend, in nanos.

created_at
integer<int64>
required

When it was installed.

events_processed
integer<int64>
required

Lifetime event count.

id
string
required

The fleet's identifier.

name
string
required

Its name in this workspace.

pending_approvals
integer<int64>
required

How many approval gates wait on a human's answer for this Fleet.

Counted on the read, so a console showing "N approvals waiting" opens on this one request rather than paging the approvals inbox for a number. The live tail's completion and gate frames carry the same count, so the figure moves without another read.

source_markdown
string
required

The authored SKILL.md, verbatim.

status
string
required

Where it stands in its life.

updated_at
integer<int64>
required

When it last changed.

bundle_content_hash
string | null

The bundle a runner materialises support files from.

trigger_markdown
string | null

The authored TRIGGER.md, or null where the bundle carried none.

triggers
object | null

What may wake this Fleet, as stored. agentsfleet returns the document unchanged.