Skip to main content
GET
List your workspaces

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.

Query Parameters

name
string

Exact tenant-scoped workspace name.

starting_after
string

Cursor returned as next_cursor by the previous page.

limit
string

How many rows to return.

Response

OK

GET /v1/tenants/me/workspaces — one page of the workspaces across every account the caller holds.

items
object[]
required

The rows on this page, oldest first.

tenant_id
string
required

The caller's own account — the authoritative resolution, carried so a client can pin its local state to the right person. Items from accounts the caller joined name theirs in account.

next_cursor
string | null

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

total
integer<int64> | null

Always null: the walk never counts, and the key stays because a client may already branch on its presence.