Security
Roles & permissions
Security
Roles & permissions
Learn how to give your team and customers access.
The DevXP engineering team hosts office hours every Thursday at 11 a.m. Pacific Time where we answer your questions live and help you get up and running with Flatfile. Join us!
Administrator Roles
Administrator roles have full access to your accounts, including inviting additional admins and seeing developer keys.
The accessToken provided will remain valid for a duration of 24 hours.
| Role | Details |
|---|---|
| Administrator | This role is meant for any member of your team who requires full access to the Account. ✓ Can add other administrators ✓ Can view secret keys ✓ Can view logs |
Guest Roles
Guest roles receive access via a magic link or a shared link depending on the Environment guestAuthentication type. Guests roles can invite other Guests unless you turn off this setting in the Guest Sidebar.
The accessToken provided will remain valid for a duration of 1 hour.
Space Grant
| Role | Details |
|---|---|
| Single-Space Guest | This role is meant for a guest who has access to only one Space. Such guests can be invited to additional Spaces at any time. |
| Multi-Space Guest | This role is meant for a guest who has access to multiple Spaces. They will see a drop-down next to the Space name that enables them to switch between Spaces. |
Workbook Grant
| Role | Details |
|---|---|
| Single-Workbook Guest | This role is meant for a guest who should have access to only one Workbook within a Space. |
| Multi-Workbook Guest | This role is intended for a guest who has access to multiple Workbooks within a Space. |
This role can only be configured using code. See code example.
const createGuest = await api.guests.create({
environmentId: "us_env_hVXkXs0b",
email: "guest@example.com",
name: "Mr. Guest",
spaces: [
{
id: "us_sp_DrdXetPN",
workbooks: [
{
id: "us_wb_qGZbKwDW",
},
],
},
],
});