FullVision
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-After response 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..."
  }
}

On this page