Skip to content

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"
  }
}