> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/product/roles.md).

# Roles and permissions

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). [Source on GitHub](https://github.com/snapfix/docs/blob/main/product/roles.md).
{% endhint %}

Snapfix has no single role field. What a person may do comes from several stored values, and each check reads the ones it needs: their **site role** and **site permissions** on one site, their **group role**, **read-only** state and **group permissions** in one group, and rules tied to one task (creator, assignee, follower). Snapfix staff have a flag of their own. The screens show these as "Admin", "Make a Site Admin", "Read-only user" and the permission switches.

Read-only applies per group. A read-only member of one group can still change tasks in another group, and no site has a read-only state.

This page says who may do what, and where the screens and the server disagree. Where each check runs (web guards, app controls, API traits) is in [Permission checks](https://docs.snapfix.com/how-the-apps-work/shared.md#permission-checks). The server rules below are the Laravel API's (api\_php\_live\_v2 @ ef3c4319f6) and authpy's (authpy @ 5d5758661c). The apps save most changes through php-apis, which acts on the user named in the request and checks less. Paths in the tables are in api\_php\_live\_v2 unless they name another repo.

## Layers

| Layer            | Stored in                                                                                                                                                                   | Values                                                                                                                                                                                  | Changed by                                                                                                                                                                                              |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Staff            | `tPri_User.fSnapfixWebAdminUser`                                                                                                                                            | 0 or 1                                                                                                                                                                                  | No code in the repos sets it to 1: the column defaults to 0 and only test seeders write 1 \[[ASK-269](https://github.com/snapfix/docs/blob/main/ASK.md#ask-269-how-does-a-person-become-snapfix-staff)] |
| Site role        | `tPri_UserParent.user_type`, one row per person and site                                                                                                                    | `admin`, `normal`, `contractor`                                                                                                                                                         | Site admins on the Users tab, and multi-site users ([Site users](https://docs.snapfix.com/product/features/console/site-users.md))                                                                      |
| Site permissions | `fCreateNewBusiness`, `fManageTag`, `fEditTagHeader`, `fManageChecklist`, `fAiAutoAssignEnabled` on `tPri_UserParent`                                                       | 0 or 1                                                                                                                                                                                  | The same people, in the "Site Permissions" card                                                                                                                                                         |
| Multi-site       | `tPri_MultiSiteUser`, one row per person and multi-site                                                                                                                     | a membership; `fAdmin` exists but nothing reads it \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)] | Multi-site users, in the Multi-Site Console                                                                                                                                                             |
| Group role       | `tPri_UserBusiness.uuid_tUserType`, one row per person and group, looked up in `tPub_UserType`                                                                              | `Admin` or `User` (`app/Enums/Role.php:5-9`)                                                                                                                                            | Whoever may manage the group's members ([Group members](https://docs.snapfix.com/product/features/groups/group-members.md))                                                                             |
| Group access     | `tPri_UserBusiness.uuid_tOnboard`, looked up in `tPub_Onboard`, and the permission columns (`perJob*`, `perBus*`, `perAssignUser`, `perAcceptAssign`, `perAccessDocuments`) | `Active`, or `Inactive` for read-only (`app/Enums/Onboard.php:5-13`); each permission 0 or 1                                                                                            | The same people, in the member dialog                                                                                                                                                                   |
| Task             | `tPri_Job.uuid_tUser_CreatedBy`, `tPri_JobUserAssigned`, `tPri_JobUser`                                                                                                     | creator, assignees, followers                                                                                                                                                           | Creating, assigning and following the task ([Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md))                                                                                          |

The site role and the group role are both called "Admin" in the product, but they are different rows. A site admin passes the site checks. The group checks read the caller's row in that group, and refuse the call when there is none, so a site admin who is not in a group has no task rights in it (`app/Traits/Authenticated.php:20-31`) \[[ASK-265](https://github.com/snapfix/docs/blob/main/ASK.md#ask-265-should-a-site-admin-manage-the-members-of-groups-they-dont-belong-to)]. The word "role" in onboarding (a job title) and in housekeeping (the role on the staff schedule) does not give permissions; see the [glossary](https://docs.snapfix.com/product/glossary.md).

## Roles

| Role                             | What it is for                                                                                                                                                                     | Shown as                                                                                                       | Stored as                                                                                                                                                                                     | How someone gets it                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Snapfix staff                    | Support work in the staff admin app, across every site                                                                                                                             | No label on customer screens                                                                                   | `tPri_User.fSnapfixWebAdminUser` = 1                                                                                                                                                          | Not documented in the repos \[[ASK-269](https://github.com/snapfix/docs/blob/main/ASK.md#ask-269-how-does-a-person-become-snapfix-staff)]. See [Snapfix staff](#snapfix-staff)                                                                                                                                                                                                                                        |
| Site admin                       | Runs one site: users and their site permissions, details, tags, rooms and areas, Comply, housekeeping and billing                                                                  | "ADMIN" badge and "Make a Site Admin" on the web; Android lists them under "Account Admin" on Site details     | `user_type` = `admin`                                                                                                                                                                         | "Make a Site Admin" on the web's Users tab, which saves at once \[[ASK-136](https://github.com/snapfix/docs/blob/main/ASK.md#ask-136-should-make-a-site-admin-ask-before-saving)], or a multi-site user ([Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md)). Extra administrators named in the setup form become plain users                                                               |
| Site user                        | Any person on a site. Has no site permissions unless given some                                                                                                                    | No label                                                                                                       | `user_type` = `normal`                                                                                                                                                                        | Added by email or phone, by invitation, by spreadsheet on the web, or by QR invitation in the apps ([Site users](https://docs.snapfix.com/product/features/console/site-users.md), [Joining a site](https://docs.snapfix.com/product/features/onboarding/join-site.md))                                                                                                                                               |
| Contractor                       | An outside worker on a site, who can be emailed a read-only link to a task they are assigned to ([Sharing tasks](https://docs.snapfix.com/product/features/tasks/task-sharing.md)) | "CONTRACTOR" badge                                                                                             | `user_type` = `contractor`                                                                                                                                                                    | The "Contractor" box in the web's Add New Users, for email users only. A contractor gets no invitation, cannot be made a site admin, and the web hides their access card ([Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md))                                                                                                                                                               |
| Multi-site user                  | Manages the sites of one multi-site                                                                                                                                                | "MULTI-SITE" badge                                                                                             | `tPri_MultiSiteUser`                                                                                                                                                                          | "Make a Multi-site Admin" in the Multi-Site Console. It is a plain membership; there is no multi-site admin role \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)] ([Multi-Site Console](https://docs.snapfix.com/product/features/console/multi-site-console.md))                                                                 |
| Group admin                      | Runs one group: its settings, members and every task in it                                                                                                                         | "Admin" in the group's users                                                                                   | group role `Admin`                                                                                                                                                                            | Creating the group, or being made admin by someone who may manage the group's members ([Groups](https://docs.snapfix.com/product/features/groups/groups.md), [Group members](https://docs.snapfix.com/product/features/groups/group-members.md))                                                                                                                                                                      |
| Group user                       | Works the group's tasks with the permissions ticked for them                                                                                                                       | "User", with "Advanced Permissions"                                                                            | group role `User`                                                                                                                                                                             | Being added to the group. The web always adds people as "User" ([Group members](https://docs.snapfix.com/product/features/groups/group-members.md))                                                                                                                                                                                                                                                                   |
| Read-only member                 | Sees a group's tasks without changing them, where the checks test it ([Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md))                                           | "Read-only user"                                                                                               | `uuid_tOnboard` = `Inactive`                                                                                                                                                                  | Ticked in the member dialog. Any group role can be read-only                                                                                                                                                                                                                                                                                                                                                          |
| Housekeeping role                | What a person does on the staff schedule for one day. Not an account role                                                                                                          | "Housekeeper", "Inspector", "Both (Inspector & Housekeeper)", "Self Checker", "House Person", "HK Maintenance" | `HousekeepingSessionRole`: `hk`, `hk-supervisor`, `hk-and-supervisor`, `self-checker`, `hk-person`, `hk-maintenance`, in `tPri_User_WorkingHours.session_role`. The last two cannot be stored | A site admin, on the web's [Staff schedule](https://docs.snapfix.com/product/features/housekeeping/staff-schedule.md)                                                                                                                                                                                                                                                                                                 |
| Task creator, assignee, follower | Rights on one task only                                                                                                                                                            | "Created by", "Assigned to", "Followed by"                                                                     | see [Layers](#layers)                                                                                                                                                                         | Creating, being assigned to or following the task                                                                                                                                                                                                                                                                                                                                                                     |
| API key                          | Machine access to one site through the Open API or the Vendor API                                                                                                                  | No label                                                                                                       | `tPri_Api_Simple_SecretKey`                                                                                                                                                                   | Staff create keys; customers have no screen for it \[[ASK-159](https://github.com/snapfix/docs/blob/main/ASK.md#ask-159-how-do-customers-and-vendors-get-api-keys)]. A request with the key acts as the staff username stored with the key, with the permissions stored with it (`app/Http/Middleware/AuthorizePublicApi.php:40-55`) ([Open API](https://docs.snapfix.com/product/features/integrations/open-api.md)) |
| Link or QR visitor               | Sees one shared task, or fills in one QR form, without signing in                                                                                                                  | No sign-in                                                                                                     | share link token; public QR form                                                                                                                                                              | Anyone with the link or the code ([Sharing tasks](https://docs.snapfix.com/product/features/tasks/task-sharing.md), [QR forms](https://docs.snapfix.com/product/features/qr/qr-forms.md))                                                                                                                                                                                                                             |

Notes:

* Snapfix has no owner role. The creator of a group becomes its admin; the creator of a task has rights on that task only.
* **Contractors** have no checks of their own. The only Laravel check that reads the contractor type is the one before the contractor email (`app/Services/UserParentService.php:158-167`, `app/Http/Controllers/v1/Versions/v1_0/App/JobSharingController.php:103`). php-apis also reads it when people are added, to give a contractor no temporary password (php-apis @ 238ca4414e, `htmlphp/api/snapfix/class/webapp.functions.php:7585-7588`). Otherwise a contractor has the same rights as a site user with the same memberships and switches \[[ASK-266](https://github.com/snapfix/docs/blob/main/ASK.md#ask-266-what-is-a-contractor-on-a-site-and-can-they-sign-in)].
* **Multi-site users** get a membership in every group of the multi-site's sites: role User, read-only, with only "View All Tasks" on (`app/Services/UserAssetBusinessService.php:434-462`, `resources/other/api_user_multisite_permission_defaults.php`). A group the person really belongs to keeps that real membership instead (`app/Services/UserAssetBusinessService.php:405-408`).
* **The apps decide group admin** by comparing `uuid_tUserType` with the fixed ID of `Admin` (ios @ aa31967ac8, `SVProgressHUD/Current.swift:113`; android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/viewModels/ChatViewModel.kt:830`). This works while that row of `tPub_UserType` keeps its ID.

## Site permissions

Site permissions are set per person and site in the Site Console's "Site Permissions" card; each switch saves at once ([Site users](https://docs.snapfix.com/product/features/console/site-users.md)). The web shows all five on for a site admin, with the switches disabled.

| Label (web)                           | Code                   | What it allows                                                                                                                                                                                                                                                                                                              | Server check                                                                                                                                                                                                                                                    | See                                                                                                                                                                                  |
| ------------------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "Create New Group"                    | `fCreateNewBusiness`   | Creating a group on the site. The web checks it; the apps do not all check it                                                                                                                                                                                                                                               | `BusinessPolicy::create` reads only this switch, for everyone (`app/Policies/BusinessPolicy.php:65-74`)                                                                                                                                                         | [Groups](https://docs.snapfix.com/product/features/groups/groups.md)                                                                                                                 |
| "Manage Tags"                         | `fManageTag`           | Tag controls and the tag editor on the Tags tab                                                                                                                                                                                                                                                                             | `TagPolicy::updateTag` needs both this and "Edit Tag Folders" for anyone but a site admin (`app/Policies/TagPolicy.php:39-52`) \[[ASK-268](https://github.com/snapfix/docs/blob/main/ASK.md#ask-268-should-manage-tags-alone-let-a-member-add-and-change-tags)] | [Site tags](https://docs.snapfix.com/product/features/console/site-tags.md)                                                                                                          |
| "Edit Tag Folders"                    | `fEditTagHeader`       | Folder controls on the Tags tab                                                                                                                                                                                                                                                                                             | As above                                                                                                                                                                                                                                                        | [Site tags](https://docs.snapfix.com/product/features/console/site-tags.md)                                                                                                          |
| "Create \| Edit \| Delete Checklists" | `fManageChecklist`     | Changing a task's checklist (`JobPolicy::updateTodo`, `app/Policies/JobPolicy.php:277-298`). It does not open the Checklists tab, which goes by site role \[[ASK-131](https://github.com/snapfix/docs/blob/main/ASK.md#ask-131-should-the-create--edit--delete-checklists-permission-let-users-manage-checklist-templates)] | `JobPolicy::updateTodo`, for members who are not read-only                                                                                                                                                                                                      | [Checklists](https://docs.snapfix.com/product/features/checklists/checklists.md), [Checklist templates](https://docs.snapfix.com/product/features/checklists/checklist-templates.md) |
| "Enable AI Auto-Assign"               | `fAiAutoAssignEnabled` | Whether assignees are suggested for the tasks this person creates                                                                                                                                                                                                                                                           | No Laravel policy reads it \[[ASK-267](https://github.com/snapfix/docs/blob/main/ASK.md#ask-267-should-every-way-of-making-someone-a-site-admin-give-enable-ai-auto-assign)]                                                                                    | [Snapfix Recommends](https://docs.snapfix.com/product/features/ai/snapfix-recommends.md)                                                                                             |

* **Making someone a site admin** sets the flags in two ways. "Make a Site Admin" goes through authpy, which turns on all five switches when the person already has a site row (authpy @ 5d5758661c, `model/feature_token_ops.py:3908-3913`), and the staff path sets five too ([Staff API](https://docs.snapfix.com/engineering-reference/api/staff.md)). The Laravel `POST /v1/app/parents/add-user` sets the admin type and four switches, not "Enable AI Auto-Assign" (`app/Http/Controllers/v1/Versions/v1_0/App/ParentController.php:500-513`); no client calls it ([Users API](https://docs.snapfix.com/engineering-reference/api/users.md)) \[[ASK-267](https://github.com/snapfix/docs/blob/main/ASK.md#ask-267-should-every-way-of-making-someone-a-site-admin-give-enable-ai-auto-assign)].
* **Guest inbox** permissions sit on the same row: `perInboxViewOnly` and `perInboxFullAccess`. A site admin passes both inbox checks; others need one of these switches, and the site's inbox must be on (`app/Policies/ParentPolicy.php:34-70`). The staging database does not have these columns yet ([Guest communications](https://docs.snapfix.com/product/features/integrations/guest-communications.md)).

## Group permissions

A group user has these permissions, stored as columns on the membership (`tPri_UserBusiness`; codes in `app/Enums/Permission.php:7-27`). A group admin passes every check that tests the admin role, and the web hides the boxes for admins ([Group members](https://docs.snapfix.com/product/features/groups/group-members.md)). The checks below also refuse read-only members, unless the column says otherwise.

| Label (web)                                                           | Code                                                        | What it allows                                                                                                                                                                                           | Server check                                                                                                                                      | See                                                                                 |
| --------------------------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| "Create New Task"                                                     | `perJobCreateNew`                                           | Creating tasks. It also gates the task list's Chat button \[[ASK-48](https://github.com/snapfix/docs/blob/main/ASK.md#ask-48-should-every-member-be-able-to-open-a-task-groups-chat-from-the-task-list)] | `JobPolicy::create` (`app/Policies/JobPolicy.php:21-34`)                                                                                          | [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)  |
| "Change task to red", "Change task to yellow", "Change task to green" | `perJobMoveToRed`, `perJobMoveToAmber`, `perJobMoveToGreen` | Setting a task to that status. The web says "yellow" for amber                                                                                                                                           | `JobPolicy::updateStatus` (`:68-97`). A group's automatic amber and green from a checklist skip it. Any assignee may change the status without it | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "View All Tasks"                                                      | `perJobViewAll`                                             | Seeing and changing every task in the group. Without it, a member sees the tasks they created, follow or are assigned to                                                                                 | `JobPolicy::view` (`:174-186`, no read-only clause) and `JobPolicy::update` (`:44-59`)                                                            | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "Hide Task Notes"                                                     | `perJobHideNotes`                                           | Meant to hide task notes from the member                                                                                                                                                                 | Nothing reads it: the task resource returns the notes to every member who can view the task (`app/Http/Resources/v1/JobData/JobResource.php:35`)  | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "Delete or Archive Tasks"                                             | `perJobDelete` and `perJobArchive`                          | Deleting and archiving tasks. Two codes, one web label                                                                                                                                                   | `JobPolicy::delete` (`:194-204`) and `JobPolicy::archiveJob` (`:136-146`)                                                                         | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "Access Attachments"                                                  | `perAccessDocuments`                                        | Attaching files to tasks                                                                                                                                                                                 | No Laravel check reads it for app users. `JobPolicy::uploadFile` (`:242-249`) reads it only for Open API and Vendor API keys                      | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "Assign Users"                                                        | `perAssignUser`                                             | Assigning people to a task, including housekeeping tasks                                                                                                                                                 | `JobPolicy::assignUser` (`:154-164`)                                                                                                              | [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)                   |
| "Generate Reports"                                                    | `perJobReportGenerate`                                      | Making task reports on the web                                                                                                                                                                           | The report actions do not check it                                                                                                                | [Task reports](https://docs.snapfix.com/product/features/reports/task-reports.md)   |
| "Create Planned Tasks"                                                | `perJobCreatePlanned`                                       | Creating and changing planned tasks; the apps also want "Create New Task" \[[ASK-51](https://github.com/snapfix/docs/blob/main/ASK.md#ask-51-which-permissions-should-planned-tasks-need)]               | No Laravel policy reads it                                                                                                                        | [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md) |
| "Group Settings Access"                                               | `perBusSettingsScreenAccess`                                | Opening and changing group settings                                                                                                                                                                      | `BusinessPolicy::update` (`app/Policies/BusinessPolicy.php:82-93`), which also passes any member who is not read-only                             | [Groups](https://docs.snapfix.com/product/features/groups/groups.md)                |
| "Add or Remove Users in Group"                                        | `perBusSettingsEditUser`                                    | Adding and removing members, and changing their roles                                                                                                                                                    | `BusinessPolicy::updateBusinessUsers` (`:101-118`). A member with it can make themselves admin                                                    | [Group members](https://docs.snapfix.com/product/features/groups/group-members.md)  |

The membership also holds permissions that the web's member dialog does not offer:

* `perBusSettingsEditTagHeading` lets a member rename the group's own tag folders (`TagPolicy::updateTagHeader`, `app/Policies/TagPolicy.php:60-71`). That check also passes read-only members.
* `perBusSettingsEditTag` is read by no live check; who should edit a group's tags is open \[[ASK-79](https://github.com/snapfix/docs/blob/main/ASK.md#ask-79-who-should-edit-a-groups-tags)].
* `perJobToDoCreate` and `perJobToDoDelete` are read by `JobPolicy::createTodo` and `deleteTodo` (`app/Policies/JobPolicy.php:257-267`, `:306-316`), which nothing calls. `perJobToDoEdit`, `perAcceptAssign` and `perBusCreateNew` are read by no check. Checklist changes follow the site switch "Create | Edit | Delete Checklists" instead.

## What each role may do

How to read the table:

* "Yes" means the screens offer it and the server allows it. Where they differ, the cell says so, and [Where the screens and the server disagree](#where-the-screens-and-the-server-disagree) sums it up.
* "As a member" means the server checks the person's membership of the group first. A site admin with no membership in the group is refused.
* "With X" means the group permission X, and the person must not be read-only in that group.
* A contractor follows the site user's rules for the groups they belong to (see [Roles](#roles)). Staff are covered under [Snapfix staff](#snapfix-staff).
* The last column names the server check, in api\_php\_live\_v2 unless it says otherwise.

### Tasks

| Action                                                                                                      | Site admin  | Group admin | Group user                                                                                                                                                                                                                                                  | Read-only member                                                                                                                                       | Multi-site user                                                                                                                                                                                                  | Server check                                                                            |
| ----------------------------------------------------------------------------------------------------------- | ----------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [Open a task](https://docs.snapfix.com/product/features/tasks/tasks.md)                                     | As a member | Yes         | With "View All Tasks", or as creator, follower or assignee                                                                                                                                                                                                  | Same rule as a group user; view only                                                                                                                   | Yes, every task: "View All Tasks" is on by default \[[ASK-100](https://github.com/snapfix/docs/blob/main/ASK.md#ask-100-should-a-multi-site-member-see-every-asset-register-and-asset-of-the-multi-sites-sites)] | `JobPolicy::view` (`app/Policies/JobPolicy.php:174-186`)                                |
| [Create a task](https://docs.snapfix.com/product/features/tasks/task-creation.md)                           | As a member | Yes         | With "Create New Task"                                                                                                                                                                                                                                      | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::create` (`:21-34`)                                                          |
| [Change a task's details](https://docs.snapfix.com/product/features/tasks/tasks.md)                         | As a member | Yes         | With "View All Tasks", or as creator, follower or assignee                                                                                                                                                                                                  | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::update` (`:44-59`), `JobController.php:556`                                 |
| [Change a task's status](https://docs.snapfix.com/product/features/tasks/tasks.md)                          | As a member | Yes         | With the permission for that colour, such as "Change task to green". The API also lets any assignee                                                                                                                                                         | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::updateStatus` (`:68-97`), `JobController.php:550-555`                       |
| [Assign users](https://docs.snapfix.com/product/features/tasks/tasks.md)                                    | As a member | Yes         | With "Assign Users"                                                                                                                                                                                                                                         | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::assignUser` (`:154-164`)                                                    |
| [Set a task's time range](https://docs.snapfix.com/product/features/tasks/tasks.md)                         | As a member | Yes         | No                                                                                                                                                                                                                                                          | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::operateAsAdmin`, from `app/Traits/JobTimeRange.php:61`                      |
| [Lock or unlock a task](https://docs.snapfix.com/product/features/tasks/tasks.md)                           | As a member | Yes         | Only as the creator                                                                                                                                                                                                                                         | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::update` first, then `operateAsAdminOrCreator` (`JobController.php:556-561`) |
| [Archive a task](https://docs.snapfix.com/product/features/tasks/tasks.md)                                  | As a member | Yes         | With "Delete or Archive Tasks"                                                                                                                                                                                                                              | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::archiveJob` (`:136-146`), after `update`                                    |
| [Delete a task](https://docs.snapfix.com/product/features/tasks/tasks.md)                                   | As a member | Yes         | With "Delete or Archive Tasks". Android offers Delete outside a task's time range to everyone, read-only members included                                                                                                                                   | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::delete` (`:194-204`)                                                        |
| [Approve or reject a task](https://docs.snapfix.com/product/features/tasks/task-approval.md)                | As a member | Yes         | The screens offer it to the assignees of an inspection task. The API lets anyone assigned to the task or to its linked inspection                                                                                                                           | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::operateAsAdmin`, or an assignee (`JobController.php:562-569`)               |
| [Change a task's checklist](https://docs.snapfix.com/product/features/checklists/checklists.md)             | As a member | Yes         | With the site switch "Create \| Edit \| Delete Checklists". Ticking and answering items check nothing                                                                                                                                                       | No                                                                                                                                                     | No                                                                                                                                                                                                               | `JobPolicy::updateTodo` (`:277-298`)                                                    |
| [Delete a chat message](https://docs.snapfix.com/product/features/chat/task-chat.md)                        | As a member | Any message | Own messages                                                                                                                                                                                                                                                | Own messages \[[ASK-44](https://github.com/snapfix/docs/blob/main/ASK.md#ask-44-should-read-only-members-post-react-and-delete-chat-messages)]         | Own messages                                                                                                                                                                                                     | `ChatPolicy::delete` (`app/Policies/ChatPolicy.php:16-26`), no read-only clause         |
| [React to a chat message](https://docs.snapfix.com/product/features/chat/task-chat.md)                      | Yes         | Yes         | Yes                                                                                                                                                                                                                                                         | Yes                                                                                                                                                    | Yes                                                                                                                                                                                                              | None: the reaction route checks no access. `ChatPolicy::chatReaction` is never called   |
| [Create, change or pause planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md) | As a member | Yes         | Creating: "Create New Task" and "Create Planned Tasks". Changing or pausing on the web: "Create Planned Tasks" only. The apps ask for both \[[ASK-51](https://github.com/snapfix/docs/blob/main/ASK.md#ask-51-which-permissions-should-planned-tasks-need)] | Not stated \[[ASK-275](https://github.com/snapfix/docs/blob/main/ASK.md#ask-275-may-read-only-members-create-planned-tasks-and-generate-task-reports)] | Same as read-only members \[[ASK-275](https://github.com/snapfix/docs/blob/main/ASK.md#ask-275-may-read-only-members-create-planned-tasks-and-generate-task-reports)]                                            | See [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md) |
| [Generate task reports](https://docs.snapfix.com/product/features/reports/task-reports.md)                  | As a member | Yes         | On the web, with "Generate Reports"                                                                                                                                                                                                                         | Not stated \[[ASK-275](https://github.com/snapfix/docs/blob/main/ASK.md#ask-275-may-read-only-members-create-planned-tasks-and-generate-task-reports)] | Same as read-only members \[[ASK-275](https://github.com/snapfix/docs/blob/main/ASK.md#ask-275-may-read-only-members-create-planned-tasks-and-generate-task-reports)]                                            | The report requests read any group named in them                                        |

### Groups

| Action                                                                                                         | Site admin                                                        | Group admin             | Group user                                                                                                                                                                                                                                                           | Read-only member                  | Multi-site user                                  | Server check                                                                            |
| -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [Create a group](https://docs.snapfix.com/product/features/groups/groups.md)                                   | Yes: every way of making a site admin turns on "Create New Group" | With "Create New Group" | With "Create New Group"                                                                                                                                                                                                                                              | With "Create New Group"           | Only with a site row that has "Create New Group" | `BusinessPolicy::create` (`app/Policies/BusinessPolicy.php:65-74`), no read-only clause |
| [Change group settings](https://docs.snapfix.com/product/features/groups/groups.md)                            | As a member                                                       | Yes                     | With "Group Settings Access" on the screens; the API lets any member who is not read-only                                                                                                                                                                            | Only with "Group Settings Access" | No                                               | `BusinessPolicy::update` (`:82-93`)                                                     |
| [Archive or delete a group](https://docs.snapfix.com/product/features/groups/groups.md)                        | As a member                                                       | Yes                     | The apps offer it to admins only; the web with "Group Settings Access"; the API lets any member who is not read-only. Who should is open \[[ASK-71](https://github.com/snapfix/docs/blob/main/ASK.md#ask-71-who-may-archive-or-delete-a-group-and-see-its-qr-codes)] | No                                | No                                               | `BusinessPolicy::update` (`:82-93`)                                                     |
| [Add or remove members, change their roles](https://docs.snapfix.com/product/features/groups/group-members.md) | Yes, in every group of the site                                   | Yes                     | With "Add or Remove Users in Group"; they can also make themselves admin                                                                                                                                                                                             | No                                | Yes, in every group of the multi-site's sites    | `BusinessPolicy::updateBusinessUsers` (`:101-118`)                                      |
| [Rename a group's own tag folder](https://docs.snapfix.com/product/features/groups/groups.md)                  | As a member                                                       | Yes                     | With `perBusSettingsEditTagHeading`, which the web does not offer                                                                                                                                                                                                    | Yes (defect)                      | Yes, as a read-only member (defect)              | `TagPolicy::updateTagHeader` (`app/Policies/TagPolicy.php:60-71`)                       |
| [Create or change the group's QR form](https://docs.snapfix.com/product/features/qr/qr-forms.md)               | As a member                                                       | Yes                     | No                                                                                                                                                                                                                                                                   | No                                | No                                               | `QrFormController.php:66`; the QR list uses `BusinessPolicy::update` (`:37`)            |

### Site

| Action                                                                                                                           | Site admin                                                                                                                                                                | Group admin                                                                       | Group user                                                                                                                                                                                                                   | Read-only member                           | Multi-site user                                                                                                                                                                                       | Server check                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Site-admin API actions: site settings, checklist templates and folders, Comply, working hours, inbox rules and other site routes | Yes, even when blocked                                                                                                                                                    | No                                                                                | No                                                                                                                                                                                                                           | No                                         | No                                                                                                                                                                                                    | `ParentPolicy::operate` (`app/Policies/ParentPolicy.php:19-32`), used by 81 calls                                                                                                                                                                                                                                                                    |
| [Site details](https://docs.snapfix.com/product/features/console/site-details.md)                                                | Yes                                                                                                                                                                       | Web: sees the page. Apps: opens it, cannot change it                              | Web: no. Apps: opens it, cannot change it                                                                                                                                                                                    | Same as group user                         | Only where a site admin                                                                                                                                                                               | `ParentPolicy::operate` for changes                                                                                                                                                                                                                                                                                                                  |
| [Site users: see the list and add people](https://docs.snapfix.com/product/features/console/site-users.md)                       | Yes                                                                                                                                                                       | Web: sees the active list and adds people. Apps: sees the list                    | Web: no. Apps: sees the list \[[ASK-130](https://github.com/snapfix/docs/blob/main/ASK.md#ask-130-should-members-who-are-not-admins-see-the-sites-user-list-in-the-apps)]                                                    | Same as group user                         | Yes, in the Multi-Site Console                                                                                                                                                                        | The list routes show any site's users to any signed-in user                                                                                                                                                                                                                                                                                          |
| [Make a site admin or set site permissions](https://docs.snapfix.com/product/features/console/site-users.md)                     | Yes                                                                                                                                                                       | No                                                                                | No                                                                                                                                                                                                                           | No                                         | Yes, for any user on the multi-site's sites, themselves included \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)] | `PUT /user/{userUUID}/site/{siteUUID}/permission` (authpy @ 5d5758661c, `model/feature_token_ops.py:3856-3860`)                                                                                                                                                                                                                                      |
| [Remove a person from the site](https://docs.snapfix.com/product/features/console/site-users.md)                                 | Web: yes. Apps: not offered \[[ASK-138](https://github.com/snapfix/docs/blob/main/ASK.md#ask-138-should-the-apps-let-site-admins-remove-users-and-reset-their-passwords)] | No                                                                                | No                                                                                                                                                                                                                           | No                                         | Yes, from the Multi-Site Console \[[ASK-127](https://github.com/snapfix/docs/blob/main/ASK.md#ask-127-should-removing-a-user-from-a-multi-site-also-remove-the-site-admin-roles-it-gave)]             | See [Site users](https://docs.snapfix.com/product/features/console/site-users.md)                                                                                                                                                                                                                                                                    |
| [See a person's devices](https://docs.snapfix.com/product/features/console/site-users.md)                                        | Yes, and the server lets a site admin of any site read any user's devices (defect)                                                                                        | No                                                                                | No                                                                                                                                                                                                                           | No                                         | Yes, any user's devices (defect)                                                                                                                                                                      | `getUserActiveDevices` (authpy @ 5d5758661c, `model/feature_token_ops.py:675-690`)                                                                                                                                                                                                                                                                   |
| [Site tags](https://docs.snapfix.com/product/features/console/site-tags.md)                                                      | Yes                                                                                                                                                                       | Same as group user; the web hides the Tags tab from them, but it opens by address | With both "Manage Tags" and "Edit Tag Folders" \[[ASK-268](https://github.com/snapfix/docs/blob/main/ASK.md#ask-268-should-manage-tags-alone-let-a-member-add-and-change-tags)]                                              | Same as group user                         | Only with a site row that allows it                                                                                                                                                                   | `TagPolicy::updateTag` (`app/Policies/TagPolicy.php:39-52`)                                                                                                                                                                                                                                                                                          |
| [Checklist templates](https://docs.snapfix.com/product/features/checklists/checklist-templates.md)                               | Yes, on the Checklists tab                                                                                                                                                | No; the folder list without buttons, by address                                   | No; "Create \| Edit \| Delete Checklists" does not open it \[[ASK-131](https://github.com/snapfix/docs/blob/main/ASK.md#ask-131-should-the-create--edit--delete-checklists-permission-let-users-manage-checklist-templates)] | No                                         | Their multi-site's templates; with several multi-sites, only the first                                                                                                                                | `ParentPolicy::operate`                                                                                                                                                                                                                                                                                                                              |
| [Rooms and areas: create, rename, delete](https://docs.snapfix.com/product/features/rooms/rooms-and-areas.md)                    | Yes                                                                                                                                                                       | Screens: no. API: yes                                                             | Screens: no. API: yes                                                                                                                                                                                                        | Screens: no. API: yes                      | Only with a site row or a real group membership in the site                                                                                                                                           | `RoomPolicy::operate`, `AreaPolicy::operate` (`app/Policies/RoomPolicy.php:19-28`, `app/Policies/AreaPolicy.php:18-27`): any site row or group membership in the site. Who should is open \[[ASK-81](https://github.com/snapfix/docs/blob/main/ASK.md#ask-81-who-may-create-rename-and-delete-rooms-and-areas-and-change-their-priority-and-status)] |
| [Room status](https://docs.snapfix.com/product/features/rooms/room-status.md)                                                    | Yes                                                                                                                                                                       | Yes                                                                               | Yes                                                                                                                                                                                                                          | Yes                                        | Only with a site row or a real group membership in the site                                                                                                                                           | `RoomPolicy::operate`, site membership only \[[ASK-81](https://github.com/snapfix/docs/blob/main/ASK.md#ask-81-who-may-create-rename-and-delete-rooms-and-areas-and-change-their-priority-and-status)]                                                                                                                                               |
| [Guest inbox](https://docs.snapfix.com/product/features/integrations/guest-communications.md)                                    | Yes                                                                                                                                                                       | With an inbox permission on their site row                                        | With an inbox permission on their site row                                                                                                                                                                                   | With an inbox permission on their site row | With an inbox permission on a site row                                                                                                                                                                | `ParentPolicy::viewInbox`, `operateInbox` (`:34-70`); automation rules also need `operate` (`InboxAutomationRuleController.php:22-23`)                                                                                                                                                                                                               |
| [Snapfix AI](https://docs.snapfix.com/product/features/ai/snapfix-ai.md)                                                         | Yes                                                                                                                                                                       | Yes                                                                               | Yes                                                                                                                                                                                                                          | Yes                                        | Not on the web while a multi-site is selected                                                                                                                                                         | Simon acts as the signed-in user, so each call follows that user's rights                                                                                                                                                                                                                                                                            |
| [Open API and Vendor API keys](https://docs.snapfix.com/product/features/integrations/open-api.md)                               | No; staff create keys \[[ASK-159](https://github.com/snapfix/docs/blob/main/ASK.md#ask-159-how-do-customers-and-vendors-get-api-keys)]                                    | No                                                                                | No                                                                                                                                                                                                                           | No                                         | No                                                                                                                                                                                                    | Staff routes only                                                                                                                                                                                                                                                                                                                                    |
| [Multi-Site Console](https://docs.snapfix.com/product/features/console/multi-site-console.md)                                    | Only if also a multi-site user                                                                                                                                            | No                                                                                | No                                                                                                                                                                                                                           | No                                         | Yes; every multi-site user gets every control \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)]                    | authpy multi-site routes check membership only                                                                                                                                                                                                                                                                                                       |

### Housekeeping, reports, billing and Comply

| Action                                                                                                                                                                                                      | Site admin                                           | Group admin                                                      | Group user                                                                                                                                                        | Read-only member   | Multi-site user         | Server check                                                                                                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Staff schedule](https://docs.snapfix.com/product/features/housekeeping/staff-schedule.md) and the [housekeeping dashboard](https://docs.snapfix.com/product/features/housekeeping/housekeeping-reports.md) | Yes, with housekeeping on and no multi-site selected | No                                                               | No                                                                                                                                                                | No                 | No                      | Web guard `authHousekeepingGuard` (web\_app\_v2 @ 0989b8e685, `src/app/services/auth/auth-guard/auth-housekeeping/auth-housekeeping.guard.ts:12`)                                                                                    |
| [Assign housekeeping tasks](https://docs.snapfix.com/product/features/housekeeping/housekeeping-assignment.md)                                                                                              | Yes: "Auto Assign Tasks", resets and the timeline    | One task, in their group                                         | One task, with "Assign Users"                                                                                                                                     | No                 | No                      | `JobPolicy::assignUser`; auto-assign needs a site admin                                                                                                                                                                              |
| [Ops Dashboard](https://docs.snapfix.com/product/features/reports/ops-dashboard.md)                                                                                                                         | Yes, when the site's task dashboard is on            | No; the analytics API refuses non-admins                         | No                                                                                                                                                                | No                 | Only where a site admin | ops\_dashboard\_be                                                                                                                                                                                                                   |
| [Subscription and billing](https://docs.snapfix.com/product/features/billing/subscriptions.md)                                                                                                              | Yes                                                  | No; the tab opens by address, but the billing session is refused | No                                                                                                                                                                | No                 | Only where a site admin | `ParentPolicy::operate`                                                                                                                                                                                                              |
| [Comply](https://docs.snapfix.com/product/features/compliance/comply.md)                                                                                                                                    | Yes                                                  | No; the pages send group admins to Fix                           | Web: no. Apps: a notice that Comply is on the web \[[ASK-114](https://github.com/snapfix/docs/blob/main/ASK.md#ask-114-who-should-see-comply-in-the-mobile-apps)] | Same as group user | Only where a site admin | Web guard `authComplyGuard` (`auth-comply.guard.ts:11`); the API answers Comply reads to more people \[[ASK-112](https://github.com/snapfix/docs/blob/main/ASK.md#ask-112-which-comply-reads-should-members-who-are-not-admins-get)] |

A read-only group admin is refused every task change that tests read-only, such as creating, assigning and archiving tasks.

## Where the screens and the server disagree

* **Read-only is not view-only in the API.** Read-only members can rename the group's own tag folders, delete their own chat messages \[[ASK-44](https://github.com/snapfix/docs/blob/main/ASK.md#ask-44-should-read-only-members-post-react-and-delete-chat-messages)], and react to any message, as anyone can. Multi-site users are read-only in every group they open through the multi-site, so they have the same gaps.
* **Group settings and deletion.** The API lets every member who is not read-only change or delete a group, whatever the screens show. Who may do this is open \[[ASK-71](https://github.com/snapfix/docs/blob/main/ASK.md#ask-71-who-may-archive-or-delete-a-group-and-see-its-qr-codes)].
* **Member roles.** A member with "Add or Remove Users in Group" can change their own role, also to admin. Site admins and multi-site users can change the members of any group on their sites, and the server does not check that an added person belongs to the group's site. The API also lets a group lose its last active admin; the screens refuse it.
* **Approval and status.** The screens offer approval to group admins and to the assignees of an inspection task ([Task approval](https://docs.snapfix.com/product/features/tasks/task-approval.md)). The API also lets anyone assigned to the task, or to its linked inspection, approve it, and any assignee change its status without the permission.
* **"Hide Task Notes" does nothing on the server**.
* **Rooms and areas.** The screens limit create, rename and delete to site admins. The API lets anyone with a site row or a group membership in the site do it one at a time; only bulk deletes need a site admin. Every member can change a room's status, on every platform ([Room status](https://docs.snapfix.com/product/features/rooms/room-status.md)). Who should be allowed is open \[[ASK-81](https://github.com/snapfix/docs/blob/main/ASK.md#ask-81-who-may-create-rename-and-delete-rooms-and-areas-and-change-their-priority-and-status)].
* **Site tags.** The help text of "Manage Tags" says it is enough to add and edit tags; the server also needs "Edit Tag Folders" \[[ASK-268](https://github.com/snapfix/docs/blob/main/ASK.md#ask-268-should-manage-tags-alone-let-a-member-add-and-change-tags)].
* **Blocked site admins keep their site-admin rights** in the Laravel API, which reads only `user_type`.
* **Multi-site users** have every multi-site control and can set any user's site role on the multi-site's sites; the server checks only membership \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)].
* **Device lists.** Any site admin of any site, and any multi-site member, can read any user's devices.
* **Site users and the Site Console.** Group admins see the Site Console on the web, and every member sees the user list in the apps \[[ASK-130](https://github.com/snapfix/docs/blob/main/ASK.md#ask-130-should-members-who-are-not-admins-see-the-sites-user-list-in-the-apps)]. Hidden Site Console tabs open by address, and the web's guard checks the site saved in the browser, not the one in the address.

## Where the web and the apps differ

| Topic                               | Web                                                                                                                                                    | iOS                                                                                                                                                                                                                                                                                                                                | Android                                                                                                                                                                                                                                                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Site Console and Site details       | Site admins and group admins; hidden tabs open by address (web\_app\_v2 @ 0989b8e685, `auth-admin.guard.ts:13`, `src/app/app.routes.ts:173-174`)       | The side menu's item for managing the account shows only for site admins (ios @ aa31967ac8, `SnapFix/SideMenuVC.swift:193-194`); Site details and the user list open for every member \[[ASK-130](https://github.com/snapfix/docs/blob/main/ASK.md#ask-130-should-members-who-are-not-admins-see-the-sites-user-list-in-the-apps)] | Site details and the user list open for every member \[[ASK-130](https://github.com/snapfix/docs/blob/main/ASK.md#ask-130-should-members-who-are-not-admins-see-the-sites-user-list-in-the-apps)]                                                                                                         |
| Group settings                      | Group admins and "Group Settings Access" holders ([Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md))       | Group admins and "Group Settings Access" holders, unless read-only (`SnapFix/BusinessListingVC.swift:2233`, `SnapFix/GroupPurposeVC.swift:118`)                                                                                                                                                                                    | The group row opens settings for group admins only; others get the purpose screen                                                                                                                                                                                                                         |
| Group QR codes and deleting a group | See the Groups table above \[[ASK-71](https://github.com/snapfix/docs/blob/main/ASK.md#ask-71-who-may-archive-or-delete-a-group-and-see-its-qr-codes)] | QR codes and Delete for group admins only (`SnapFix/BusinessDetailsVC.swift:787-791`)                                                                                                                                                                                                                                              | The QR card (not for asset registers) and the Delete row for group admins only; a tap on Delete by anyone else does nothing, and a user's last group cannot be deleted (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/fragment/BusinessDetailsFragment.java:187-188`, `:238`, `:318-324`) |

## Snapfix staff

* Staff sign in to the staff admin app with the staff flag on their user. The Laravel admin routes refuse anyone without it (`app/Providers/RouteServiceProvider.php:51-59`, `app/Http/Middleware/WebAdmin.php:23-24`). The admin app itself checks the flag only in the browser, and apipy's staff routes accept any user's login.
* Calls on the admin and internal route groups pass every group check: they count as group admin, never read-only, with every permission. The route name decides this, not the request (`app/Traits/Authenticated.php:20-24`, `app/Helpers/common.php:413-424`).
* Staff work across all sites. Their screens are in [Staff admin app](https://docs.snapfix.com/product/features/staff/staff-admin.md). The admin app says an "Account Superadmin" is needed before a payment link is sent, and no doc defines it \[[ASK-212](https://github.com/snapfix/docs/blob/main/ASK.md#ask-212-what-is-an-account-superadmin-and-should-a-payment-link-wait-until-the-site-has-one)].
* How a person becomes staff is not documented \[[ASK-269](https://github.com/snapfix/docs/blob/main/ASK.md#ask-269-how-does-a-person-become-snapfix-staff)].


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/product/roles.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
