Agent

ComputersUpdate

Tenant-owned durable computer resource.

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

POST /agent/v1/computers/{computer_id}● Supported

Request parameters

  • computer_idstring必填

    path: Computer id (cmp_...), as returned by computers.create or computers.list.

  • namestring必填

    Name of the entry or object.

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

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.