Agent

ComputersCreate

Tenant-owned durable computer resource.

POST /agent/v1/computers● Supported

Request body

  • namestring必填

    Name of the entry or object.

  • environment_idstring可选

    Environment recipe id; null or omitted when none was selected.

Returns

201

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 201

Computer result

application/json

NameTypeDescription
typestringAlways `computer`. A computer.
idstringComputer id (cmp_...), the computer_id of computer calls.
namestringDisplay name of the computer, 1 to 255 characters.
sandbox_idstring | nullPublic id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
environment_idstring | nullEnvironment recipe the computer was created with; null when none.
statusstringactive computers can be used by new sessions; archived ones keep their files readable but cannot start new sessions.
created_atstringRFC 3339 time at which the computer was created.
updated_atstringRFC 3339 time at which the computer was last modified.
archived_atstring | nullRFC 3339 time at which the computer was archived; null while active.