Alternate Reviewer Settings

Configure the fallback reviewer selection methods used when a valid reviewer cannot be assigned.

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.

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.

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)

{
  "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:

{
  "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:

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

Example response:

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

get

Authorizations

bearerAuth

AuthorizationstringRequired

Veza API key for authentication. Generate keys in Administration > API Keys.

Responses

200

OK

application/json

default

Default error response

application/json

get

/api/private/workflows/access/global_settings/alternate_reviewer_settings

HTTPcURLJavaScriptPython

GET /api/private/workflows/access/global_settings/alternate_reviewer_settings HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "value": {
    "selection_methods": [
      1
    ]
  }
}

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:

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]
  }
}'

put

Authorizations

bearerAuth

AuthorizationstringRequired

Veza API key for authentication. Generate keys in Administration > API Keys.

Body

application/json

Responses

200

OK

application/json

objectOptional

default

Default error response

application/json

put

/api/private/workflows/access/global_settings/alternate_reviewer_settings

HTTPcURLJavaScriptPython

PUT /api/private/workflows/access/global_settings/alternate_reviewer_settings HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "value": {
    "selection_methods": [
      1
    ]
  }
}

{}