v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Approver Groups

Replace approver

Swap one approver in an approver group for another user without rebuilding the rest of the approval flow — the V3 replacement for V1 PUT /v1/approval_flows/{id}/approver_groups/{id}/replace_approver. The remove_user_id must currently be an unresolved approver on this group; resolved groups (already approved or rejected) cannot be modified. The add_user_id must be a different user, must not already be an approver anywhere else in the same approval flow, and must have read access to the underlying job or offer. To replace the entire set of groups on a flow, use PUT /v3/approval_flows/{id}/replace_approver_groups instead.

put/v3/approver_groups/{id}/replace_approver

Path parameters

idinteger required

Request body

remove_user_idinteger required

Id of the user currently in this approver group who should be removed. The user must be an unresolved approver on this group; resolved (approved or rejected) groups cannot be modified.

add_user_idinteger required

Id of the user who should take the removed approver's place in this group. Must differ from remove_user_id, must not already be an approver anywhere in the same approval flow, and must have permission to read the underlying job or offer.

Response

Successful (No Content)