insufficient_scope
The key lacks the permission this endpoint needs
HTTP 403insufficient_scope
The credential is valid but was not granted the scope the endpoint requires. The message names the scope.
Why it happens
- The key was created with a narrow set of scopes, which is the recommended way to create one.
- A team member holds a role that does not include the action, such as a developer reaching billing.
How to fix it
- Read the scope from the message and mint a key that carries it. Scopes are
resource:action, for exampleemails:send. - There is deliberately no all-permissions key: a leaked key should cost you one capability, not the account.
Is it worth retrying?
Only after you change something. Retrying as-is will fail again.
What the response looks like
HTTP/1.1 403
Content-Type: application/json
Woyra-Request-Id: req_01J...
{
"error": {
"code": "insufficient_scope",
"message": "…",
"doc_url": "https://docs.woyra.io/errors/insufficient_scope",
"param": null,
"request_id": "req_01J..."
}
}