# Alternate Reviewer Settings

{% hint style="warning" %}
**Early Access Feature**: The Alternate Reviewer Settings API endpoint is currently in Early Access as part of the `private` API namespace. The endpoint is subject to change as features are added or modified.
{% endhint %}

Configure the ordered list of fallback selection methods that Veza uses when a valid reviewer cannot be assigned. When all specified reviewers are prevented from assignment (due to self-review prevention, the reviewer deny list, or missing managers/owners), Veza evaluates each selection method in order until an allowed alternate reviewer is found.

For more information, see [Reviewer Selection Methods](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/reviewer-selection-methods).

## Parameters

The `selection_methods` array accepts integer or string values representing fallback methods to enable. Enabled methods are evaluated in the specified order.

| Integer | String Value                        | Description                                   |
| ------- | ----------------------------------- | --------------------------------------------- |
| `1`     | `REVIEWERS_MANAGER`                 | Assign the manager of the prevented candidate |
| `2`     | `CERTIFICATION_ALTERNATE_REVIEWERS` | Assign to the first valid fallback reviewer   |
| `3`     | `WORKFLOW_CREATOR`                  | Assign to the workflow creator                |
| `4`     | `ADMIN`                             | Assign to an arbitrary local Veza admin user  |

## Example request body (PUT)

```json
{
  "value": {
    "selection_methods": ["REVIEWERS_MANAGER", "CERTIFICATION_ALTERNATE_REVIEWERS", "WORKFLOW_CREATOR", "ADMIN"]
  }
}
```

This enables all four fallback methods in order: reviewer's manager, then fallback reviewers, then workflow creator, then admin.

For example, to enable only the first two methods:

```json
{
  "value": {
    "selection_methods": [1, 2]
  }
}
```

With this configuration, Veza will not fall back to the workflow creator or a system administrator. Rows are left unassigned if no valid manager or fallback reviewer exists.

## Get Alternate Reviewer Settings

Retrieve current alternate reviewer selection method settings:

```bash
curl -L 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/alternate_reviewer_settings' \
-H 'Authorization: Bearer YOUR_API_KEY'
```

Example response:

```json
{
  "value": {
    "selection_methods": [
      "REVIEWERS_MANAGER",
      "CERTIFICATION_ALTERNATE_REVIEWERS",
      "WORKFLOW_CREATOR",
      "ADMIN"
    ]
  }
}
```

{% openapi src="<https://1967633068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZDkWMxox3pekd0NsZJ%2Fuploads%2Fgit-blob-78f548f68894fbfb26b0fd9627c7e562be046dfa%2Fopenapi.yaml?alt=media>" path="/api/private/workflows/access/global\_settings/alternate\_reviewer\_settings" method="get" %}
[openapi.yaml](https://1967633068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZDkWMxox3pekd0NsZJ%2Fuploads%2Fgit-blob-78f548f68894fbfb26b0fd9627c7e562be046dfa%2Fopenapi.yaml?alt=media)
{% endopenapi %}

## Set Alternate Reviewer Settings

Update the alternate reviewer selection methods. The order of values in the `selection_methods` array determines the evaluation order.

Using integer values:

```bash
curl -L -X PUT 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/alternate_reviewer_settings' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
  "value": {
    "selection_methods": [1, 2, 3, 4]
  }
}'
```

{% openapi src="<https://1967633068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZDkWMxox3pekd0NsZJ%2Fuploads%2Fgit-blob-78f548f68894fbfb26b0fd9627c7e562be046dfa%2Fopenapi.yaml?alt=media>" path="/api/private/workflows/access/global\_settings/alternate\_reviewer\_settings" method="put" %}
[openapi.yaml](https://1967633068-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZDkWMxox3pekd0NsZJ%2Fuploads%2Fgit-blob-78f548f68894fbfb26b0fd9627c7e562be046dfa%2Fopenapi.yaml?alt=media)
{% endopenapi %}