Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

group_id
string<uuid>
required

The ID of the group.

Response

200 - application/json

The reviewer stages for this group.

require_manager_approval
boolean
required

Whether this reviewer stage should require manager approval.

Example:

false

operator
enum<string>
required

The operator of the reviewer stage. Admin and manager approval are also treated as reviewers. A stage that sets escalation must use OR; AND is rejected there, because the escalation timer joins the stage as an additional reviewer and would otherwise become a required approver that stalls every request until the timeout.

Available options:
AND,
OR
Example:

"AND"

owner_ids
string<uuid>[]
required

The IDs of owners assigned as reviewers for this stage.

require_admin_approval
boolean

Whether this reviewer stage should require admin approval.

Example:

false

service_user_ids
string<uuid>[]

The IDs of service users assigned as reviewers for this stage.

escalation
object

Escalation for a reviewer stage. When set, the request advances to the reviewers named here if nobody responds within delay_minutes. Timely approval by any of the stage's own reviewers resolves the stage without escalating.

owner_ids and user_ids name only who to escalate to; the stage's own reviewers are added automatically and must not be repeated here. A stage with owner_ids [X] escalating to Y sets escalation.owner_ids to [Y], and reviewing after escalation is then open to both X and Y.

Because the stage's reviewers are unioned in rather than copied, removing someone from the stage also removes them from the escalation. At least one owner or user named here must not already be a reviewer of the stage.

Example:
Last modified on October 5, 2026