API reference

Computers API

Create, inspect, operate, and release a browser, computer, or sandbox through one resource contract.

Create

POST/v1/computers

Request

curl https://api.t.computer/v1/computers \
  -X POST \
  -H "Authorization: Bearer $T_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-computer" \
  -d '{
    "name": "devbox",
    "surface": "sandbox",
    "provider": "auto",
    "image": "ubuntu:24.04",
    "cpu_millis": 1000,
    "memory_mb": 1024
  }'

Inspect

GET/v1/computers/{id}

The normal lifecycle is pending → routing → assigned → starting → ready → deleting → stopped. Provider attempts and ordered events are available on child endpoints.

Operate

POST/v1/computers/{id}/exec

POST/v1/computers/{id}/open

POST/v1/computers/{id}/screenshot

GET/v1/computers/{id}/cdp

The synchronous exec endpoint is limited to 25 seconds. Queue longer work through durable executions.

Release

DELETE/v1/computers/{id}

Deletion is idempotent when you send an Idempotency-Key. Release computers promptly to close usage accounting.