Documentation Index
Fetch the complete documentation index at: https://docs.lasscyber.com/llms.txt
Use this file to discover all available pages before exploring further.
| HTTP status | 403 Forbidden |
| Code | forbidden |
| Retry? | No — request additional permissions. |
When this happens
The request authenticated successfully but the credential lacks the permission needed to perform the action. Common causes:- The API key is missing a scope (e.g. tries to delete a policy with
only
policy:read). - The credential belongs to tenant A but the request targets a resource in tenant B (a cross-tenant access attempt).
- The role attached to the user does not allow the action (e.g. a
viewertrying to mutate something). - A specialised case: the JWT user has not verified their email — see
email_not_verifiedwhich surfaces with the same 403 status but a differentcode.
Example response
How to fix
- Compare the action you attempted against the role matrix.
- If you control the API key, mint one with the right scope set.
- If you are a member without the right role, ask an owner or admin to grant it.
- If the resource simply belongs to a different tenant, switch tenants in the dashboard or use a key from the right tenant.
SDK behaviour
| SDK | Exception |
|---|---|
| Python | agnes.PermissionError |
| TypeScript | PermissionError |
Related
- Roles & permissions
- API keys — scope picker.
email_not_verified— same status, different cause.