{"uid":"cap_08P5nEY6Kqnb4cgZrm1hv","slug":"vaaya-modal-sandbox-status-3aeb8182","name":"Vaaya Modal Sandbox Status","description":"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.","url":"https://vaaya.ai/api/run/modal/sandbox-status","method":"POST","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6xk3hyZebdKPHVouG8xoN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Check the current status of a running Modal sandbox by sandbox ID","exampleAgentPrompt":"Can you check the status of my Modal sandbox with ID 'sb-xK9mP3qLrT2' and tell me if it's still running or has finished?","exampleUseCases":[{"title":"Polling sandbox after code execution","prompt":"I just kicked off a sandbox run with ID 'sb-abc123' — can you check if it's done yet and what the result is?"},{"title":"Monitoring long-running demo build","prompt":"We're building a product demo in a Modal sandbox, ID is 'sb-demo-47xQ'. Can you keep an eye on it and let me know when it finishes or errors out?"},{"title":"Checking pipeline step completion","prompt":"My go-to-market automation pipeline spun up a sandbox with ID 'sb-gtm-89zR' — is it still running or has it completed successfully?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:38.400Z","isFirstParty":false}