Permissions
This page lists who can do what in DV Forge, action by action, for each of the five roles
and the two API token scopes. Use it to decide which role to give someone and which scope a
CI token needs. Projects, roles and tokens explains the roles
themselves.
How to read the matrix
- Roles are a ladder: viewer < member < triager < project_admin < org_admin. A role can
do everything the roles to its left can.
- Roles are per organization and apply to every project in it.
- API tokens belong to one project. A
read token acts as a viewer and an
ingest:write token as a member, except for actions that need a person (marked
"person only" below). Tokens never see any other project.
- ✓ means allowed; — means refused with
403. Anything in a project you can't see is 404
instead, never 403.
- "Own" means only for the item's author or uploader, whatever their role.
Projects, people and tokens
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
See your organizations and projects (/v1/me) |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ (its project) |
✓ (its project) |
| List the organization's members (assignee and notify pickers) |
✓ |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Create a project (API only) |
— |
— |
— |
✓ |
✓ |
— |
— |
| List, issue or revoke API tokens (API only) |
— |
— |
— |
✓ |
✓ |
— |
— |
Adding people to an organization and changing roles isn't available in the app or the API
yet. Ask your DV Forge contact.
Data planes
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See the organization's data planes |
✓ |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Point a project at a data plane, or back to none |
— |
— |
— |
✓ |
✓ |
— |
— |
| Register or revoke a data plane |
— |
— |
— |
— |
✓ |
— |
— |
Regressions and logs
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See regressions, jobs, summaries and logs |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
Upload results (dvforge upload) |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ |
| Paste logs with Ingest regression |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ (API) |
| Delete a regression (API only) |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ |
Signatures
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See signatures, their history, activity, comments and attachments |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Export signatures or the triage queue as CSV |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Edit a signature's title or classification |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Merge, unmerge or split a signature |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Accept or dismiss a duplicate suggestion |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| See bucketing settings |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Change bucketing masks, preview them, or re-bucket |
— |
— |
— |
✓ |
✓ |
— |
— |
Triage
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See the triage queue and its summary |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Watch or stop watching a signature (person only) |
✓ |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Read your notifications (person only) |
✓ |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Comment (person only) |
— |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Edit a comment |
— |
Own |
Own |
Own |
Own |
— |
— |
| Delete a comment |
— |
Own |
Own |
✓ |
✓ |
— |
— |
| Attach a file, up to 10 MB (person only) |
— |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Delete an attachment |
Own |
Own |
Own |
✓ |
✓ |
— |
— |
| Change status (any status except Waived) |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Confirm root cause (moves to Root-caused) |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Waive a signature |
— |
— |
— |
✓ |
✓ |
— |
— |
| Assign or unassign |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Link or unlink a bug |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Create, rename or delete labels; add or remove them |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Bulk status, assign or label, up to 200 signatures |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Bulk watch or unwatch (person only) |
✓ |
✓ |
✓ |
✓ |
✓ |
— |
— |
Editing or deleting your own comment needs the member role. Deleting your own attachment
doesn't, so someone moved down to viewer can still remove files they uploaded. Bulk waiving
needs project_admin, like a single waiver.
Saved searches and rules
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See your own and shared saved searches |
✓ |
✓ |
✓ |
✓ |
✓ |
Shared only |
Shared only |
| Save a search (person only) |
— |
✓ |
✓ |
✓ |
✓ |
— |
— |
| Edit or delete your own saved search |
Own |
Own |
Own |
Own |
Own |
— |
— |
| Edit or delete someone else's shared saved search |
— |
— |
— |
✓ |
✓ |
— |
— |
| Change the filter of a saved search that a rule scopes to |
— |
— |
Own |
✓ |
✓ |
— |
— |
| See rules and the Rule run log; preview a rule |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Create, edit, enable, disable, delete or reorder rules |
— |
— |
✓ |
✓ |
✓ |
— |
— |
| Create, edit or delete a rule with Run the root-cause agent |
— |
— |
— |
✓ |
✓ |
— |
— |
Changing the filter of a search that rules scope to is the same as editing those rules, so
it needs the role they need: triager, or project_admin if one of them runs the agent. This
applies to the search's owner too. A search that a rule scopes to can't be
unshared or deleted until no rule uses it.
Root-cause agent
| Action |
viewer |
member |
triager |
project_admin |
org_admin |
read |
ingest:write |
| See runs, hypotheses and the Dashboard |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
✓ |
| Run root-cause on a signature |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ (API) |
| Start a run from New run |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ (API) |
| Delete a run (not while it's running) |
— |
✓ |
✓ |
✓ |
✓ |
— |
✓ |