ComputersFilesList

Call Create computer first and replace cmp_123 with its returned ID.

GET /agent/v1/computers/{computer_id}/files● Supported

Request parameters

computer_idstring必填
path: Computer id (cmp_...), as returned by computers.create or computers.list.
pathstring可选
默认 "/"
query: Directory on the computer to list; absolute path as returned in the path field of an earlier listing. Omit it to list from the computer's root.

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[].path	string	Absolute path of the entry on the computer.
data[].name	string	Name of the entry or object.
data[].type	string	Kind of entry: a file, a directory or a symbolic link.
data[].size	integer	Size in bytes.
data[].mime_type	string	MIME type of the file.
data[].read_only	boolean	True when the entry cannot be modified through the API.
data[].digest	string \| null	Content digest of the file; null when not computed.
data[].updated_at	string \| null	RFC 3339 time at which the object was last modified.
has_more	boolean	Whether more items exist beyond this page.