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 ports when a service needs a public URL.
3

Manage

Get details, list computers, stop and start long-lived computers, or delete temporary computers.
Celesto accepts Nano (1 vCPU, 512 MB), Small (1 vCPU, 1 GB), Standard (2 vCPU, 4 GB), and Large (4 vCPU, 12 GB). Free and Nano plans can create Nano computers. Builder and Growth can create every named size. See Choose computer size.

​
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. TypeScript exposes this as ramMb.
​
disk_size_mb
integer
required
Disk allocated in MB. TypeScript exposes this as diskSizeMb.
​
template_id
string
required
Sandbox template the computer was created from. TypeScript exposes this as templateId.
​
template_version
string
Pinned template version, if one was provided at create time. TypeScript exposes this as templateVersion.
​
connection
object
Connection details for accessing a running computer.
Last modified on July 17, 2026