# Clervo Sandbox Execute

> Clervo Sandbox Execute is a paid API for AI agents from api.clervo.dev, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Executes a sandboxed code or task run and returns a structured outcome with exit code, stdout, and settlement receipt

## Facts

- Endpoint: POST https://api.clervo.dev/v1/sandbox/execute
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clervo-sandbox-execute-d5770cce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xvueh2nRlbye8MiFj0OeT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability clervo-sandbox-execute-d5770cce -d '<json body>'
```

Example prompt: Run my sandbox task on Clervo and give me back the stdout output and exit code — I need to confirm it settled successfully.

## When to prefer this

Choose this endpoint when you need to execute a sandboxed task or code run within the Clervo agent infrastructure ecosystem, particularly when you require a verifiable outcome receipt with settlement confirmation via x402 micropayments. Ideal for agent pipelines that need auditable, paid execution with structured stdout and exit code output.

## Known failure modes

- Execution failure: non-zero exitCode returned with error output in stdoutBase64
- Payment not settled: receipt.settlement.status not 'settled', indicating x402 payment issue
- Invalid payload: malformed request body causes rejection before execution
- Timeout: sandbox execution exceeds allowed time limit
- Authentication failure: missing or invalid x402 payment header returns 402 error

## How this service works

Bounded sandbox.run discovery challenge

## Output

Returns a JSON object with a 'state' field (e.g. RECEIPTED), a 'result' containing execution output (kind, exitCode, stdoutBase64), a 'receipt' with settlement status, a 'replayed' boolean, and the 'productId' used for the run.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "args": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 4096,
    "minLength": 1
   },
   "maxItems": 29
  },
  "code": {
   "type": "string",
   "maxLength": 262144,
   "minLength": 1
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "path",
     "contentBase64"
    ],
    "properties": {
     "path": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
     },
     "contentBase64": {
      "type": "string",
      "maxLength": 1398104
     }
    },
    "additionalProperties": false
   },
   "maxItems": 32,
   "description": "Decoded code, stdin, and file content share a 1048576-byte aggregate envelope."
  },
  "limits": {
   "type": "object",
   "properties": {
    "cpuMillis": {
     "type": "integer",
     "maximum": 30000,
     "minimum": 1
    },
    "diskBytes": {
     "type": "integer",
     "maximum": 1073741824,
     "minimum": 1048576
    },
    "processes": {
     "type": "integer",
     "maximum": 64,
     "minimum": 1
    },
    "wallTimeMs": {
     "type": "integer",
     "maximum": 60000,
     "minimum": 100
    },
    "memoryBytes": {
     "type": "integer",
     "maximum": 536870912,
     "minimum": 16777216
    },
    "outputBytes": {
     "type": "integer",
     "maximum": 1048576,
     "minimum": 1
    },
    "artifactBytes": {
     "type": "integer",
     "maximum": 1048576,
     "minimum": 1
    }
   },
   "additionalProperties": false
  },
  "command": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 4096,
    "minLength": 1
   },
   "maxItems": 32,
   "minItems": 1
  },
  "runtime": {
   "enum": [
    "node",
    "python"
   ],
   "type": "string"
  },
  "stdinBase64": {
   "type": "string",
   "maxLength": 1398104
  },
  "artifactPaths": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "path"
    ],
    "properties": {
     "path": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
     },
     "filename": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "mimeType": {
      "type": "string",
      "maxLength": 129,
      "minLength": 3
     }
    },
    "additionalProperties": false
   },
   "maxItems": 32
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "state": "RECEIPTED",
  "result": {
   "output": {
    "kind": "execution",
    "exitCode": 0,
    "stdoutBase64": "cmVhZHk="
   }
  },
  "receipt": {
   "settlement": {
    "status": "settled"
   }
  },
  "replayed": false,
  "productId": "sandbox.run"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clervo-sandbox-execute-d5770cce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clervo.dev](https://www.zero.xyz/host/api.clervo.dev/llms.txt)