# Vaaya Modal Sandbox Status

> Vaaya Modal Sandbox Status is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Check the current status of a running Modal sandbox by sandbox ID

## Facts

- Endpoint: POST https://vaaya.ai/api/run/modal/sandbox-status
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-modal-sandbox-status-3aeb8182
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_08P5nEY6Kqnb4cgZrm1hv

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 vaaya-modal-sandbox-status-3aeb8182 -d '<json body>'
```

Example prompt: Can you check the status of my Modal sandbox with ID 'sb-xK9mP3qLrT2' and tell me if it's still running or has finished?

## When to prefer this

Use this endpoint when you have already launched a Modal sandbox via Vaaya and need to poll or check its execution state without managing your own Modal account or API keys. Prefer this over direct Modal API calls when operating within the Vaaya agent ecosystem where x402 micropayments handle authentication automatically.

## Known failure modes

- Invalid or non-existent sandbox_id returns an error or not-found response
- Sandbox may have expired or been garbage collected, returning a stale or missing status
- Network timeout if the Vaaya proxy is slow or Modal API is unresponsive
- Malformed request body (missing sandbox_id) returns a validation error
- Payment failure (insufficient USDC balance) blocks the request before it reaches Modal

## How this service works

Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.

## Output

Returns the current state of the specified Modal sandbox, including whether it is running, completed, or failed, along with any relevant status metadata or output from the execution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "sandbox_id"
     ],
     "properties": {
      "sandbox_id": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-modal-sandbox-status-3aeb8182/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)