insufficient_scope (403)

← Error reference

insufficient_scope

HTTP status: 403

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

The key is valid but lacks the scope required for this endpoint.

When it fires

A handler called `requireScope(ctx, "<scope>")` and the request key did not include `<scope>`.

How to handle it

In the console, regenerate the key with the missing scope, or grant it to the existing key. The required scope appears in the `message` field.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/insufficient_scope",
    "code": "insufficient_scope",
    "message": "Requires scope: applicants:write",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/insufficient_scope"
  }
}