---
title: "Replace approver"
method: PUT
path: "/v3/approver_groups/{id}/replace_approver"
tags: ["Approver Groups"]
---

# Replace approver

`PUT /v3/approver_groups/{id}/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.

## Path parameters

- `id` integer, required

## Request body

- object
  - `remove_user_id` integer, 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_id` integer, 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 `204`

Successful (No Content)

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Content

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)
