Skip to main content
GET
List Environments

Authorizations

Authorization
string
header
required

Workspace API key as a bearer token: Authorization: Bearer ish_sk_live_.... Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: sessions:run (create a session, submit turns, close), sessions:read (read the session and its decision trace), environments:read and environments:write (manage the workspace's registered environments), tasks:read and tasks:write (manage the workspace's registered tasks), people:read and people:write (the people the workspace can run a session for), and usage:read (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with sessions:run, sessions:read, and tasks:read by default; every other scope must be requested, people:read and usage:read included. An ish user access token also works on the same header for personal scripts.

Path Parameters

workspace_id
string<uuid>
required

Query Parameters

include_archived
boolean
default:false

Response

Successful Response

Every environment in the workspace, oldest first.

Deliberately unpaginated: an environment is a hand-registered config object (the measured ceiling is a handful per workspace, not a stream), so a cursor would be ceremony. If that stops being true this grows the same keyset shape the session list uses, which is what the envelope fields below reserve room for.

items
EnvironmentResponse · object[]
required
has_more
boolean
default:false

Always false today: this list is not paginated and returns the whole collection. Present so pagination can land without a wire break.

next_cursor
string | null

Always null today (see has_more). Will carry the opaque keyset cursor for the next page if this list becomes paginated.