List Environments

GET /agent/v1/environments◐ Partial

Request parameters

include_archivedboolean可选
query: Include archived environments in the response
limitnumber可选
query: Number of items per page.
pagestring可选
query: Opaque pagination cursor: pass the next_page value of the previous response unchanged. Omit it for the first page. A cursor from a different query or a malformed one returns 400.

Returns

200

Supports tenant-owned cloud environments, configuration updates and soft archival; built-ins are read-only. Lists accept limit, page and include_archived. Limited networking applies at sandbox creation; package installation failure terminates the session with ENVIRONMENT_PACKAGE_INSTALL_FAILED. self_hosted, scope and cross-session package caching are not supported.

Errors follow the Anthropic error format (type / message / request_id) — see error codes

Response

HTTP 200

Successful response

application/json

Name	Type	Description
data	array<object>	Items of this page, in the order requested by the call.
data[].id	string	Environment identifier (e.g., 'env_...')
data[].archived_at	null \| string	RFC 3339 timestamp when environment was archived, or null if not archived
data[].config	object	Environment configuration (either Anthropic Cloud or self-hosted)
data[].created_at	string	RFC 3339 timestamp when environment was created
data[].description	null \| string	User-provided description for the environment; null when unset
data[].metadata	object	User-provided metadata key-value pairs
data[].name	string	Human-readable name for the environment
data[].type	string	The type of object (always 'environment')
data[].updated_at	string	RFC 3339 timestamp when environment was last updated
data[].scope	string	The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.
next_page	string \| null	Opaque cursor for the next page: pass it unchanged as page to continue. Null when this is the last page.