Three independent layers decide access: role (RBAC) — what you can do; RLS — which rows you see; account standing check — whether the account is in good standing. See Roles, RLS and Suspension.
Permissions / RBAC / RLS#
| Symptom | Likely cause | How to check | Fix | Prevention |
|---|---|---|---|---|
"Action not allowed for this role" (403) | role below the required one | check the role in the RBAC matrix | the owner raises the role | assign the minimum role per job function |
| Member can't run query/refresh/AI | costly action requires admin+ | see the roles matrix | raise to admin or use an appropriate account | reserve costly actions for admins |
| Person sees zero rows | RLS fail-closed (missing attribute) | check the member's attribute | set the attribute (e.g., filial) in the profile | standardize attributes when onboarding |
| Person sees too many rows | RLS grant not configured | check the dashboard's grant | create the {column, memberAttribute} grant | review RLS when publishing |
| RLS attribute "doesn't stick" | case difference/typo | the key is normalized | check the attribute name | use consistent attribute names |
| Member sees PII they shouldn't | viewPII turned on | check the fine-grained permission | turn off viewPII in the profile | least privilege by default |
| PII column disappeared from the dashboard | masking by viewPII | expected for anyone without viewPII | grant viewPII if appropriate | classify PII in the catalog |
Everything returns 402 | subscription overdue/suspended | see Suspension | the owner settles it in Plans | keep an eye on billing |
org_admin can't see data | expected behavior (org is structural) | confirm workspace membership | become a member of the target workspace | separate administration from data access |
Export (xlsx / pdf / pptx)#
| Symptom | Likely cause | How to check | Fix | Prevention |
|---|---|---|---|---|
| Export blocked | role without data export or 402 | check role/billing | raise the role / settle payment | reserve export for member+ |
| Export has more rows than the screen | virtualization (screen ≠ export) | compare screen vs. file | the export brings the full total (expected) | explain the difference to users |
| Report PDF isn't generated | PDF dependency not configured | see Export and distribution | confirm provisioning | test delivery before scheduling |
| Export with RLS doesn't filter | per-recipient RLS not configured | check the report subscription | configure the per-recipient filter | validate RLS when sending reports |
| PII showed up in an export | whoever exported has viewPII | check the author's permission | remove viewPII from those who shouldn't have it | govern PII by role/permission |
Quick check#
403→ a role/scope problem (RBAC). Adjust the role.- Zero rows → an RLS problem (missing attribute = denyAll). Set the attribute.
402→ a billing problem (not permissions). Settle it.
Related#
Last reviewed: 2026-09-08. RBAC and RLS are fail-closed: without permission, access is denied.