Skip to main content
POST
/
api
/
sandboxes
/
{id}
/
agent
Create Agent Session
curl --request POST \
  --url https://app.opencomputer.dev/api/sandboxes/{id}/agent \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "model": "<string>",
  "systemPrompt": "<string>",
  "allowedTools": [
    "<string>"
  ],
  "permissionMode": "<string>",
  "maxTurns": 123,
  "cwd": "<string>",
  "mcpServers": {},
  "resume": "<string>"
}
'
{
  "sessionID": "as-abc123",
  "sandboxID": "sb-abc123",
  "running": true,
  "startedAt": "2025-01-15T10:30:00Z",
  "claudeSessionID": ""
}
Create a new agent session running the Claude Agent SDK inside the sandbox. Events stream over the exec session WebSocket transport.
​
id
string
required
Sandbox ID
​
prompt
string
Initial prompt
​
model
string
Claude model name
​
systemPrompt
string
System prompt
​
allowedTools
string[]
Restrict available tools
​
permissionMode
string
Permission mode
​
maxTurns
integer
Maximum turns
​
cwd
string
Working directory
​
mcpServers
object
MCP server configuration
​
resume
string
Session ID to resume
{
  "sessionID": "as-abc123",
  "sandboxID": "sb-abc123",
  "running": true,
  "startedAt": "2025-01-15T10:30:00Z",
  "claudeSessionID": ""
}