Skip to content

app.invite_links

TableRow level security on

Shareable invitation links (Section 4.8.1): anyone signed in with the link joins with its role until it expires, runs out of uses or is revoked. Only a SHA-256 hash of the token is stored; the token is shown once.

Primary key: id

Columns of app.invite_links
ColumnTypeNullableDescription
iduuidNoPrimary key, UUID v7.
org_iduuidNoOwning org. A row never moves to another org.References app.organizations.id
role_iduuidNoRole a person receives on joining.References app.roles.id
token_hashbyteaNoSHA-256 of the link token.
expires_attimestamp with time zoneNoWhen the link stops working.
max_usesintegerNoHow many people may join with it.
use_countintegerNoHow many have joined with it. Set by the database.
revoked_attimestamp with time zoneYesWhen it was revoked.
deleted_attimestamp with time zoneYesSoft delete time. A row with deleted_at set is ignored by every access helper.
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