API Reference
Programmatically create, manage and monitor sandbox environments.
Request (Headers)
Authorization: Basic <base64>
Response (200 OK)
{
"token": "jwt_token"
}
Request Body
{
"engine": "firecracker",
"cpu": 2,
"memory": "4GB"
}
Response (201 Created)
{
"sandbox_id": "sbx_123456",
"status": "created"
}
Request Body
{
"sandbox_id": "sbx_123456",
"file": "sample.py"
}
Response (202 Accepted)
{
"execution_id": "exec_987",
"status": "running"
}
// Returns text/plain stream of sandbox stdout/stderr
// Returns 204 No Content
Error Codes
| Status Code |
Description |
| 401 Unauthorized | Invalid or missing authentication token. |
| 403 Forbidden | Insufficient permissions for this action. |
| 404 Not Found | The requested sandbox or resource does not exist. |
| 429 Rate Limited | Too many requests. Back off and retry. |
| 500 Internal Error | An unexpected orchestration failure occurred. |