List approver groups

Approver groups are the ordered tiers of approvers inside a single approval flow on a job or offer. Each group has its own approvals_required threshold (e.g., "any 1 of 3" or "all 4") and resolves as approved once that many of its members approve, or as rejected once enough members reject. Groups with a lower sort_order must resolve as approved before later groups become actionable. Filter to a specific flow with approval_flow_ids and look up the individual people in each group via /v3/approvers?approver_group_ids=. To restructure the tiers themselves, use PUT /v3/approval_flows/{id}/replace_approver_groups; to swap one person within a group, use PUT /v3/approver_groups/{id}/replace_approver.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

integer
1 to 500
Defaults to 100

Number of results per page

ids
array of integers
length ≤ 50

Comma separated list

ids
created_at
object
updated_at
object
approval_flow_ids
array of integers
length ≤ 50

Return only the approver groups belonging to these approval flow IDs. Each approver group is a single step in its parent flow's approver chain. Use sort_order to order the steps within a flow.

approval_flow_ids
fields
array of strings
length ≤ 50

Comma separated list of fields to return

fields
Response

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json