Who Can Decide What
If you think “an administrator can do anything” or “an owner can decide everything”, you will design it wrong. Authority is not arranged in steps. Roles are independent by layer, and the right to decide a review is set on yet another axis.
This page explains who can decide how far. How to choose reviewers is in the Review Guide.
Roles are divided into two layers
Roles are divided into two layers. On the management side there is the administrator, who handles registered agents, contracts, and certification in the admin console. On the project side there are owner, operator, and member.
The two layers are separate. Having a role in one layer does not automatically give you a role in the other. Even a project owner cannot change a registered agent's contract or certification; an administrator does that in the admin console.
There is also the organization operations role, which lets a person operate without taking part in the project.
Project roles are owner, operator, and member
An owner can change the project's settings and start cases. Only the owner can edit a case's settings and artifacts.
An operator can perform operating actions such as cancelling a case, stopping a cycle execution, setting a case's deadline, reassigning reviewers, and pausing and resuming the project. They cannot change settings, and cannot edit a case's settings or artifacts.
A member can view cases and can start cases. They can cancel a case they started themselves. In a step where they are named as a reviewer, they can decide the review.
The organization operations role is an “operations” role attached to an organization, separate from project roles. A person with it can start cases even without taking part in the project. They can also cancel cases, stop cycle executions, extend a review request's deadline, and reassign reviewers. They cannot open the settings screens or make other changes.
A list of who can do what is under “Cases (workflows)” in the Settings Reference.
A review is not decided by role
This is where it is most often misunderstood.
Whether you can decide a review is not determined by being an owner, operator, or member. Only the reviewer named for each review step, and a delegate they have handed it to for a period, can decide.
Even an owner cannot decide a review unless named as a reviewer of that step (or a delegate). Do not assume that “putting the owner in makes approvals go round”. Conversely, someone named as a reviewer cannot correct a case's settings or artifacts unless they are the owner. If you want something corrected, send it back or ask the owner.
Only members of the project can be named. A reviewer can hand decisions to one person in the same organization while away (“Delegate for review requests” in personal settings; a delegate cannot hand it on to someone else).
Runs are carried out in the name of the project's owner
A project's runs are carried out in the name of the project's owner. When a registered agent is launched, the request carries that owner as the principal of the run. The owner's authority is for managing the project, and is separate from the name a run is carried out in. An owner changes the project's owner under the Settings tab's “Transfer ownership”. The new owner must be an active user in the project's organization (or, if there is none, in your own organization). You cannot transfer while there is open work, such as a running case or a review awaiting a decision. After the transfer, the project is paused (it stays stopped while an administrator has it stopped). Resuming is the same as the usual resume.
Who can call the external API
The external API can be called with two kinds of token. A service account token can perform, on every project in this environment, the operations a service account is allowed. A token of a user who logged in through an external tool can call it according to that person's role in the project and their organization operations role (User API Reference (Projects)).
What to read next
- Human Review — What a reviewer decides
- Review Guide — Who to make a member and who to make a reviewer
- Case Guide — Who can start, edit, and cancel a case