Skip to content

Permissions

<!-- source: the registerPermissions() calls in packages/*/src/server/permissions.ts, plus packages/data-models/src/server/registrations.ts (per-model permissions) and packages/rbac/src/server/rbac-permissions.ts. Group labels: admin.rbac.editor.categories in services/web/src/messages/en.json. Regenerate by re-reading those calls. -->

Every permission a role can grant, by module, as listed in Admin > Roles & permissions > the role editor. "Group" is the heading the permission sits under there.

Built-in roles

RoleGrants
AdministratorEvery permission in the organization, including permissions added later. The only role that opens Admin.
System administratorEvery permission in every organization on the instance. Granted outside the app; see System administrator actions.

achievements

PermissionGroupGrants
achievements.manageachievementsCreate and configure achievements and the conditions that award them.
achievements.viewachievementsSee the achievements gallery and your own badges.

api-keys

PermissionGroupGrants
api-keys.manageAPI keysCreate, list and revoke your own API keys. A key never does more than its owner can.
api-keys.manage-service-accountsAPI keysCreate and manage the organization's service accounts and their keys. A service-account key acts as the account, not a person.

automation

PermissionGroupGrants
automation.createAutomationCreate and edit flows.
automation.manageAutomationTurn flows on and off and delete them, including flows that use privileged steps (roles, user management).
automation.runAutomationStart a test run by hand.
automation.viewAutomationSee flows and their run history.

calendar

PermissionGroupGrants
calendar.createCalendarCreate calendars.
calendar.deleteCalendarDelete calendars. A personal calendar can't be deleted.
calendar.editCalendarChange a calendar's name, description and color.
calendar.manageCalendarEverything above, plus deciding which roles can use each calendar.
calendar.viewCalendarSee the calendars and events the role has access to.

chat

PermissionGroupGrants
chat.managechatReserved for moderating every conversation in the organization. Not checked anywhere yet.
chat.usechatUse chat: see your own conversations and send messages, including to the AI assistant.

data-models

PermissionGroupGrants
data-models.manage-formsData modelsCreate and manage public forms, approve board entries, and hide or delete board comments.
data-models.manage-record-scopesData modelsAdd or remove a record scope on a role. Kept apart from schema editing, because whoever can remove a scope can widen their own access.
data-models.manage-schemaData modelsCreate, edit, reorder and archive models and their fields, and set up integrations such as the calendar.
data-models.read-schemaData modelsSee model and field definitions. Needed, with record-read, to open Data.
data-models.record-bulk-writeData modelsEdit many records at once. Needs record-write as well.
data-models.record-deleteData modelsDelete records, in every model.
data-models.record-readData modelsRead records, in every model.
data-models.record-writeData modelsCreate and edit records, in every model.
data-models.view-all-recordsData modelsSee every record, ignoring per-record role restrictions. Leave it off for roles that design models but shouldn't read restricted records.

Per-model permissions

Each model adds three permissions, under a group named Data Model: followed by the model's name. <key> is the model's key, taken from its first name.

PermissionGrants
data-models.<key>-record-deleteDelete records in this model only.
data-models.<key>-record-readRead records in this model only.
data-models.<key>-record-writeCreate and edit records in this model only.

feature-flags

PermissionGroupGrants
feature-flags.readPlatformSee feature flag definitions and overrides.
feature-flags.writePlatformSet or remove feature flag overrides.

files

PermissionGroupGrants
files.deleteFilesDelete files.
files.manage-bucketsFilesCreate storage buckets and set their size and type limits.
files.uploadFilesUpload files.
files.viewFilesList files and download them.

github

PermissionGroupGrants
github.managegithubConnect GitHub for the organization: pick the token secret, generate the webhook secret.

kanban

PermissionGroupGrants
kanban.createKanbanCreate boards.
kanban.deleteKanbanDelete boards and cards.
kanban.editKanbanEdit boards, columns and cards: create, move and update cards, rename columns.
kanban.manageKanbanEverything above, plus deciding which roles can use each board.
kanban.viewKanbanSee the boards and cards the role has access to.

organizations

PermissionGroupGrants
organizations.invite-memberUsersNot checked anywhere yet. Inviting people requires the Administrator role.
organizations.remove-memberUsersNot checked anywhere yet. Removing people requires the Administrator role.
organizations.update-settingsOrganizationChange the organization's assistant name. Its other settings require the Administrator role.

rbac

PermissionGroupGrants
rbac.assign-admin-roleRoles & permissionsNot checked anywhere yet. Giving or removing the Administrator role requires being an administrator.
rbac.assign-roleRoles & permissionsLets a flow use the automation step that gives or removes a role. In Admin, assigning roles requires the Administrator role.
rbac.manage-rolesRoles & permissionsNot checked anywhere yet. Creating, editing and deleting roles requires the Administrator role.

secrets

PermissionGroupGrants
secrets.manageSecretsCreate, change and delete secrets.
secrets.readSecretsSee secret names and details. Values are never shown, under any permission.

telegram

PermissionGroupGrants
telegram.managetelegramConnect Telegram for the organization: store the bot token and register with Telegram.

twitter

PermissionGroupGrants
twitter.managetwitterConnect X for the organization: store its API credentials.

users

PermissionGroupGrants
users.disableUsersLets a flow use the automation step that disables a user account.
users.manage-profileUsersLets a flow use the automation step that edits another user's profile.
users.read-metadata-for-module-calendarCalendarNot checked; each person's calendar view settings are always their own.
users.write-metadata-for-module-calendarCalendarNot checked; each person's calendar view settings are always their own.

webhooks

PermissionGroupGrants
webhooks.readPlatformSee webhook endpoints, their subscriptions and delivery history.
webhooks.retryPlatformRetry a delivery by hand.
webhooks.writePlatformCreate, edit and delete endpoints, and rotate their secrets.

wiki

PermissionGroupGrants
wiki.createwikiCreate pages.
wiki.deletewikiDelete and restore pages, with everything nested under them.
wiki.readwikiRead pages.
wiki.updatewikiEdit pages and move them in the tree.