OPERATION_REQUIRES_SESSION
This operation is only available from the web session; it cannot be performed with an API key or OAuth.
Category: Authentication
| HTTP status | 403 Forbidden |
| Retry | No |
When it happens
The operation is available only from a signed-in dashboard session. No API key, live or test, can perform it, whatever scopes it holds.
How to fix it
Do it from the dashboard.
Retry
Do not retry. The outcome is final: sending the same request again gets the same answer.
Returned by
The operations where this code is most likely. The list is not exhaustive.
Example response
When this error occurs, the API answers 403 Forbidden with a JSON body of this shape:
{
"type": "https://docs.beel.es/errors/OPERATION_REQUIRES_SESSION",
"title": "OPERATION_REQUIRES_SESSION",
"detail": "This operation is only available from the web session; it cannot be performed with an API key or OAuth.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "OPERATION_REQUIRES_SESSION",
"message": "This operation is only available from the web session; it cannot be performed with an API key or OAuth.",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
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 '‹value›' must contain a company identifier (UUID).
ACTIVE_COMPANY_NOT_ACCESSIBLE
The selected company does not belong to your account