Skip to docs content
RBAC roles and permissions
Free Cloud
Pro
Workers
SDK js@latest
Updated 2026-08-12

RBAC roles and permissions

Editions: Free Cloud · Pro · Workers

Roles gate what an app user (or API key bound to a role) may do on secured GraphQL. Platform/Console admins use a separate permission system — do not conflate the two.

Configure roles

  1. Project → Roles & permissions (wording may vary by Console version).
  2. Create roles (e.g. admin, editor, viewer).
  3. Grant model capabilities: read / write / delete (and any engine-specific flags).
  4. Assign roles to app users.

API keys may inherit a default role — check project auth settings.

Effective permissions

Apps should treat “can this user call mutation X?” as server-enforced. UI soft-gates are optional; never rely on hiding buttons alone.

SaaS

Combine RBAC with tenant isolation: a user may be admin within tenant A and have no access to tenant B. Always pass tenant context on queries.

Next