Skip to main content
The Computers API gives your code or agent an isolated Linux computer. You create a computer, run work inside it, and then stop, start, or delete it when your workflow is done.

​
Computer lifecycle

1

Create

Create a new computer from scratch or a template such as coding-agent.
2

Run

Execute shell commands, inspect output, and publish supported ports when a service needs a public URL.
3

Manage

Get details, list computers, stop and start long-lived computers, or delete temporary computers.

​
Computer response fields

​
id
string
required
Unique identifier for the computer, such as cmp_abc123.
​
name
string
required
Auto-generated display name for the computer, such as einstein.
​
status
string
required
Current status. One of: creating, running, stopping, stopped, starting, restoring, restorable, deleting, deleted, or error.
​
vcpus
integer
required
Number of virtual CPUs allocated.
​
ram_mb
integer
required
Memory allocated in MB.
​
disk_size_mb
integer
required
Disk allocated in MB.
​
template_id
string
required
Sandbox template the computer was created from.
​
template_version
string
Pinned template version, if one was provided at create time.
​
connection
object
Connection details for accessing a running computer.
Last modified on June 7, 2026