Reviewer Bulk Actions Settings

Control which bulk actions are available to reviewers.

This setting provides granular control over bulk operations in Access Reviews. With it, administrators can selectively disable specific actions, based on organizational security policies and compliance requirements.

When a bulk action is enabled (all actions are enabled by default), reviewers choose the action to multiple rows at once using row selection, "Select All", or filter-based operations. When disabled, the specified action is hidden from the reviewer interface, for any operations affecting two or more rows.

Bulk action restrictions apply only to users with the reviewer role. Administrators and operators are not affected by these settings. Single-row operations (acting on one row at a time) are never restricted.

All fields default to true (all bulk actions allowed). This setting can be configured globally for all reviews, or for specific review configurations by workflow_id parameter.

The fallback precedence is:

• configuration-specific setting → global setting → default (all enabled).

When a bulk action is disabled, any Smart Actions that use the disabled action type are also hidden from reviewers. For example, if bulk approve is disabled, a Smart Action that includes an approve step will not be shown to reviewers.

Parameters

The request body accepts:

• allow_bulk_approve (boolean) - Enable or disable bulk approve for reviewers

• allow_bulk_reject (boolean) - Enable or disable bulk reject for reviewers

• allow_bulk_signoff (boolean) - Enable or disable bulk sign-off for reviewers

• allow_bulk_clear_decisions (boolean) - Enable or disable bulk clear decisions for reviewers

• allow_bulk_add_note (boolean) - Enable or disable bulk add note for reviewers

• allow_bulk_reassign (boolean) - Enable or disable bulk reassign for reviewers

• workflow_id (optional string) - Specific review configuration ID to override global settings

Examples

Example request body to disable bulk approve and reject globally while keeping other bulk actions enabled:

{
  "value": {
    "allow_bulk_approve": false,
    "allow_bulk_reject": false,
    "allow_bulk_signoff": true,
    "allow_bulk_clear_decisions": true,
    "allow_bulk_add_note": true,
    "allow_bulk_reassign": true
  }
}

Example request body to disable all bulk actions for a specific review configuration:

{
  "value": {
    "allow_bulk_approve": false,
    "allow_bulk_reject": false,
    "allow_bulk_signoff": false,
    "allow_bulk_clear_decisions": false,
    "allow_bulk_add_note": false,
    "allow_bulk_reassign": false
  },
  "workflow_id": "8ae1c414-3a76-46cb-950a-925316b3f264"
}

Get Reviewer Bulk Actions Settings

Retrieve the current reviewer bulk actions settings. Include the optional workflow_id query parameter to get settings for a specific review configuration.

Global Settings Request:

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

Configuration-Specific Request:

curl -L 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/reviewer_bulk_actions?workflow_id=8ae1c414-3a76-46cb-950a-925316b3f264' \
-H 'Authorization: Bearer YOUR_API_KEY'

Example response:

{
  "value": {
    "allow_bulk_approve": true,
    "allow_bulk_reject": true,
    "allow_bulk_signoff": true,
    "allow_bulk_clear_decisions": true,
    "allow_bulk_add_note": true,
    "allow_bulk_reassign": true
  }
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

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

Query parameters

workflow_idstringOptional

Optional. If empty, returns the global tenant setting. If provided, returns the workflow-specific setting.

Responses

200

OK

application/json

default

Default error response

application/json

get

/api/private/workflows/access/global_settings/reviewer_bulk_actions

HTTPcURLJavaScriptPython

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

{
  "value": {
    "allow_bulk_approve": true,
    "allow_bulk_reject": true,
    "allow_bulk_signoff": true,
    "allow_bulk_clear_decisions": true,
    "allow_bulk_add_note": true,
    "allow_bulk_reassign": true
  }
}

Set Reviewer Bulk Actions Settings

Update the reviewer bulk actions settings globally or for a specific review configuration.

Global Settings Request:

curl -L -X PUT 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/reviewer_bulk_actions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
  "value": {
    "allow_bulk_approve": false,
    "allow_bulk_reject": false,
    "allow_bulk_signoff": true,
    "allow_bulk_clear_decisions": true,
    "allow_bulk_add_note": true,
    "allow_bulk_reassign": true
  }
}'

Configuration-Specific Request:

curl -L -X PUT 'https://your-organization.vezacloud.com/api/private/workflows/access/global_settings/reviewer_bulk_actions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
  "value": {
    "allow_bulk_approve": false,
    "allow_bulk_reject": false,
    "allow_bulk_signoff": false,
    "allow_bulk_clear_decisions": false,
    "allow_bulk_add_note": false,
    "allow_bulk_reassign": false
  },
  "workflow_id": "8ae1c414-3a76-46cb-950a-925316b3f264"
}'

Example response:

{}

put

Authorizations

bearerAuth

AuthorizationstringRequired

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

Body

application/json

workflow_idstringOptional

Optional. If empty, sets the global tenant setting. If provided, sets the workflow-specific setting.

Responses

200

OK

application/json

objectOptional

default

Default error response

application/json

put

/api/private/workflows/access/global_settings/reviewer_bulk_actions

HTTPcURLJavaScriptPython

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

{
  "value": {
    "allow_bulk_approve": true,
    "allow_bulk_reject": true,
    "allow_bulk_signoff": true,
    "allow_bulk_clear_decisions": true,
    "allow_bulk_add_note": true,
    "allow_bulk_reassign": true
  },
  "workflow_id": "text"
}

{}