ErrorsAll codes
INSUFFICIENT_SCOPE
The API key lacks the required permissions (scopes) for this operation.
Category: Authentication
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/INSUFFICIENT_SCOPE",
"title": "INSUFFICIENT_SCOPE",
"detail": "The API key lacks the required permissions (scopes) for this operation.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "The API key lacks the required permissions (scopes) for this operation.",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The API key lacks the required permissions (scopes) for this operation.
La API key no tiene los permisos (scopes) necesarios para esta operación.
L'API key no té els permisos (scopes) necessaris per a aquesta operació.
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ACCOUNT_MANAGEMENT_FORBIDDEN
Only the owner or an admin can manage account settings.
ACCOUNT_NOT_ACCESSIBLE
You do not have access to that account
ACCOUNT_REQUIRES_FOCUS_SWITCH
You are a member of that account, but it is not your active account right now. Switch your active account and try again.
ACTIVE_COMPANY_HEADER_INVALID
Header ''{0}'' must contain a company identifier (UUID).
ACTIVE_COMPANY_NOT_ACCESSIBLE
The selected company does not belong to your account