Stealth Browser Errors
Stealth errors use this shape:
{
"code": "unauthorized",
"detail": "missing or invalid X-API-Key"
}code is one word for programs. detail is a sentence. Extra number fields may appear on the same object (slots, TTL, bytes, dollars) when relevant.
Codes
code | Typical meaning |
|---|---|
unauthorized | Missing or invalid X-API-Key |
no_plan | No active Stealth plan |
account_restricted | Account cannot use the API |
not_found | Session, profile, or recording not found |
no_recording | No recording for this session |
validation | Request body or parameters failed validation |
plan_engine | Engine not allowed on the plan |
plan_ttl | TTL above the plan max |
plan_slots | Session slot capacity reached |
country | Country not allowed |
quota | Monthly quota exhausted |
start_failed | Session failed to start |
backend_full | Backend capacity unavailable |
billing_unavailable | Billing could not be checked |
HTTP status map (common)
| HTTP | When |
|---|---|
| 401 | Unauthorized |
| 402 | No plan or quota |
| 403 | Restricted |
| 404 | Not found |
| 422 | Validation / plan engine / TTL / country |
| 429 | Plan slots |
| 502 / 503 | Upstream or backend capacity |
Retry guidance
- Do not retry
unauthorized,validation,no_plan, or most422codes without fixing the request backend_fulland some start failures may succeed after a short wait- Keep
detail(and any numeric fields) when you contact support
Was this page helpful?