Skip to content

insufficient_scope

insufficient_scope: HTTP 403, authorization error. This API key does not have the permission this request needs.


Code insufficient_scope
Type authorization_error
HTTP status 403
Default message This API key does not have the permission this request needs.

The key is valid but was not given the permission this call needs (for example payments:write to create a payment). Make a key with that permission in the dashboard. See Authentication.

We know who you are, but this is not allowed for that key or account.

Every error has the same shape; error.code is this code, and meta.request_id is what to quote when you ask us about a request.

{
"error": {
"type": "authorization_error",
"code": "insufficient_scope",
"detail": "This API key does not have the permission this request needs.",
"documentation_url": "https://docs.baiyar.com/resources/errors/insufficient_scope/"
},
"meta": { "request_id": "req_…" }
}

All error codes