Errors
Errors return JSON with an error message:
{ "error": "Your balance is empty — add credit to start machines" }
| Status | Meaning | What to do |
|---|---|---|
400 |
Invalid input | Check the body fields |
401 |
Missing or invalid token | Check the Authorization header |
402 |
Balance is empty | Top up, then retry |
403 |
Not allowed (wrong origin, admin-only, machine token on a non-MCP route) | Use an API key |
404 |
Machine not found (or not yours) | Check the id |
409 |
Machine isn't running | Start it first |
429 |
Too many attempts, or machine limit reached | Wait, or destroy unused machines |
502 |
The machine's container couldn't be reached | Retry; contact support if it persists |