> For the complete documentation index, see [llms.txt](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/developers/api/workflows/access-review-settings/alternatereviewersettings.md).

# 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](/4yItIzMvkpAvMVFAamTf/features/access-reviews/configuration/reviewer-selection-methods.md).

## 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="/files/Aco9gj4MY2XoNiD4zIjr" 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-0d9d5973a247f0dc34943ed932d00eb6f5a41e3e%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="/files/Aco9gj4MY2XoNiD4zIjr" 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-0d9d5973a247f0dc34943ed932d00eb6f5a41e3e%2Fopenapi.yaml?alt=media)
{% endopenapi %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.veza.com/4yItIzMvkpAvMVFAamTf/developers/api/workflows/access-review-settings/alternatereviewersettings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.