Skip to main content
GET
List the tenant's workspaces

Authorizations

Authorization
string
header
required

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

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 tenant's workspaces.

items
object[]
required

The rows on this page, oldest first.

tenant_id
string
required

Whose list this is — the authoritative resolution, carried so a client can pin its local state to the right tenant.

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.