Skip to content

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) — ✓ ✓ ✓ ✓ — ✓