Skip to content

app.roles

TableRow level security on

Platform system roles (org_id null, generated from capabilities.yaml) and org custom roles built from the capability set (Section 8).

Primary key: id

Columns of app.roles
ColumnTypeNullableDescription
iduuidNoRole id.
org_iduuidYesOrg that owns a custom role; null for the seven platform system roles.References app.organizations.id
codetextNoRole code. System role labels come from the i18n catalogs keyed by it; custom role codes never reuse a system code.
nametextYesDisplay name of a custom role; null for system roles.
bandsmallintNoBand in Section 8 order, 1 Owner to 7 Viewer. Custom roles take 2 to 7. A person may assign only roles at or below their own band; seats count members whose best band is above Field.
descriptiontextYesWhat the role is for.
created_attimestamp with time zoneNoWhen the row was inserted. Set by the database.
created_byuuidYesPerson who inserted the row, or null for a platform process. Set by the database.References app.people.id
updated_attimestamp with time zoneNoWhen the row last changed. Set by the database.
updated_byuuidYesPerson who last changed the row, or null for a platform process. Set by the database.References app.people.id
deleted_attimestamp with time zoneYesSoft delete time. A row with deleted_at set is ignored by every access helper.