missing_api_key

No API key was sent

HTTP status

401

Error type

authentication

What it means#

The request arrived with no X-API-Key header.

What to do#

Send your key as a header on every request — there is no session and no cookie:

X-API-Key: gv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Common cause: a proxy or SDK that strips unrecognised headers. Confirm the header survives the hop by calling /v1/meta/usage, which is free and needs nothing else.

The error shape#

{
  "error": {
    "type": "authentication",
    "code": "missing_api_key",
    "message": "\u2026",
    "doc_url": "https://docs.grahvani.in/errors/missing_api_key",
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T"
  }
}

Full list: all error codes · error handling guide.