# Reviewer Bulk Actions Settings

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.

{% hint style="info" %}
**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.
{% endhint %}

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).

{% hint style="warning" %}
When a bulk action is disabled, any [Smart Actions](https://docs.veza.com/4yItIzMvkpAvMVFAamTf/developers/api/workflows/smart-action-definitions) 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.
{% endhint %}

## 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:

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

```json
{
  "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:**

```bash
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:**

```bash
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:

```json
{
  "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
  }
}
```

{% 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/reviewer\_bulk\_actions" 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 Reviewer Bulk Actions Settings

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

**Global Settings Request:**

```bash
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:**

```bash
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:

```json
{}
```

{% 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/reviewer\_bulk\_actions" 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 %}