ComputersList

GET /agent/v1/computers● Supported

Request parameters

limitinteger可选
默认 20
query: Maximum number of items to return in this page: a positive integer, at most 100 (default 20; for session resources default and maximum are 1000). A larger value returns 400.
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

Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.

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

Response

HTTP 200

Computer result

application/json

Name	Type	Description
data	array<object>	Items of this page, in the order requested by the call.
data[].type	string	Always `computer`. A computer.
data[].id	string	Computer id (cmp_...), the computer_id of computer calls.
data[].name	string	Display name of the computer, 1 to 255 characters.
data[].sandbox_id	string \| null	Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
data[].environment_id	string \| null	Environment recipe the computer was created with; null when none.
data[].status	string	active computers can be used by new sessions; archived ones keep their files readable but cannot start new sessions.
data[].created_at	string	RFC 3339 time at which the computer was created.
data[].updated_at	string	RFC 3339 time at which the computer was last modified.
data[].archived_at	string \| null	RFC 3339 time at which the computer was archived; null while active.
has_more	boolean	Whether more items exist beyond this page.
next_page	string \| null	Opaque cursor for the next page: pass it unchanged as page to continue. Null when this is the last page.