Skip to content

unauthorized

HTTP 401 · The request carried no usable API key.

What causes it

No `Authorization: Bearer` header and no `X-API-Key` header, a key that matches no active key, or a key past its expiry date. The `detail` member says which — it is written for a human reading logs, not for a branch in your code.

What to do

Check the header name and that the scheme is exactly `Bearer` with a capital B. If the key is right, it may have been revoked or expired: ask Vaki for a new one.

Retry?

No — the same request produces the same answer.

The response

{
  "type": "https://developers.vaki.co/errors/unauthorized",
  "title": "…",
  "status": 401,
  "code": "unauthorized",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.