Browse docs
Errors
Errors keep an error string and add a stable code and recovery action. Some guest and host errors expose only error; always read it. Never assume a failed HTTP response means a write did nothing.
{"error":"add prepaid credit to cover 15 minutes of the resulting running computers, then retry this same request","code":"insufficient_balance","action":"prepay_then_retry","balance_usd":0.1,"required_balance_usd":0.1875,"topups_url":"https://api.usepanes.com/v1/topups","funding_url":"https://usepanes.com/dashboard/billing"}| Status | Recovery |
|---|---|
| 400 | Correct the named field. For a rejected wallet signature, authorize the original quote again. |
| 401 | Supply a valid key. Expired or exhausted email challenges need a new signup challenge. |
| 402 | Prepay and retry the original compute request key. On a payment endpoint, authorize the returned protocol challenge. |
| 403 | Check account permissions, suspension or dispute state. A different payment will not remove a suspension. |
| 404 | List this account's resources and check the ID. After uncertain create, use its request-key lookup. |
| 409 | Read current state. Check Office readiness, restore state, cloning protection or idempotency-body mismatch. |
| 413 | Split the request or use direct file transfer. Input bodies are limited to 64 KiB. |
| 429 | Follow Retry-After. For an explicit account restriction, stop/delete unused resources or contact support. |
| 500 / 502 / 503 / 504 | Inspect current state before retrying writes. For capacity errors, wait and retry the same compute request key. |
When uncertain: true, a write or command may already have happened. For computer creation, use /v1/machine-requests/{key}. For payment, poll its status URL. For commands and input, inspect output files and the desktop. Never repeat a payment to recover an uncertain response.
Unexpected server errors include a support reference. Send that reference or the top-up/computer ID to support@usepanes.com, without keys, payment credentials or document contents.