Skip to main content
GET
List fleets in a workspace

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.

Query Parameters

starting_after
string

Opaque page token from a prior response's next_cursor field, formatted {created_at_epoch_ms}:{fleet_id}. Omit for the first page. The retired cursor spelling is refused.

limit
string

Page size. Defaults to 20. Clamped to a maximum of 100.

Response

OK

GET /v1/workspaces/{workspace_id}/fleets — one page, newest first.

items
object[]
required

The fleets on this page.

total
integer
required

How many Fleets this page carries. The count covers this page only, not the whole workspace.

Required range: x >= 0
next_cursor
string | null

Where the next page resumes, or null on the last one.