insufficient_scope (403)
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"
}
}