Errors
auth_unavailable
503 — API key could not be verified
What happened
FullVision could not verify your API key for this request, so it refused the request rather than serving it.
Why it usually happens
The key store was unreachable and your key was not in the verification cache. Your key is probably fine — FullVision could not confirm it either way.
How to fix
- Retry after the delay in the
Retry-Afterresponse header (30 seconds). - Use exponential backoff if the retry also fails.
- Do not mint a new key — this is not a verdict on your key.
- If it lasts more than a few minutes, report it with the
trace_id.
Envelope
{
"error": {
"code": "auth_unavailable",
"message": "Key verification is temporarily unavailable. Retry shortly.",
"param": null,
"doc_url": "https://docs.fullvision.io/errors/auth_unavailable",
"trace_id": "tr_01HXYZ..."
}
}