authentication_required (401)

← Error reference

authentication_required

HTTP status: 401

Retryable: No — retrying without changes will fail the same way.

No API key was supplied with the request.

When it fires

The `Authorization` header is missing. Every endpoint under `/v1/*` requires a valid bearer key.

How to handle it

Send `Authorization: Bearer <key>`. Never embed the key in URLs or query parameters — it will leak into logs and CDN caches.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/authentication_required",
    "code": "authentication_required",
    "message": "Invalid or missing API key",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/authentication_required"
  }
}