Skip to main content
POST
Create a sandbox

Authorizations

Authorization
string
header
required

Long-lived opaque API key minted by an approved user at /api. The secret is shown once, stored only as a SHA-256 digest, and disabled immediately when either the key or its API access grant is revoked.

Headers

Idempotency-Key
string
Required string length: 1 - 255

Body

application/json
repos
object[]
required
Minimum array length: 1
prompt
string
required
Required string length: 1 - 60000
model
string
Required string length: 1 - 200
reasoningEffort
enum<string>
Available options:
none,
low,
medium,
high,
xhigh,
max,
ultra,
ultracode
title
string
Required string length: 1 - 120
toolApprovalMode
enum<string>
default:auto
Available options:
auto,
prompt
metadata
object

Response

An identical sandbox creation was already accepted

id
string
required
Pattern: ^c_[a-z2-9]{12}$
worktreeId
string
required
read-only
Minimum string length: 1
object
string
required
Allowed value: "sandbox"
status
enum<string>
required
Available options:
queued,
creating,
running,
succeeded,
failed,
terminating,
terminated
title
string
required
repos
object[]
required
model
string | null
required
agentRuntime
enum<string>
required
Available options:
opencode,
codex,
claude,
grok
turn
object
required
usage
object
required
metadata
object
required
error
string | null
required
createdAt
string
required
startedAt
string | null
required
completedAt
string | null
required