**Source URL:** https://limited.veevavault.dev/safety/vault-api/api-reference/23.3/document-roles/remove-users-and-groups-from-roles-on-multiple-documents.md

# Remove Users and Groups from Roles on Multiple Documents



Remove users and groups from roles on a document or binder in bulk.

* The maximum CSV input file size is 1GB.

* The values in the input must be UTF-8 encoded.

* CSVs must follow the standard RFC 4180 format, with some [exceptions](/vault-api/references/csv-rfc-deviations).

* The maximum batch size is 1000.

<Endpoint path="/api/{version}/objects/documents/roles/batch" method="DELETE"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `text/csv` or `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## Body Parameters {#body-parameters}

You can add parameters in the request body, or upload them as a CSV file.

<FieldTable>
| Name | Description |
| --- | --- |
| `id` | The document ID. |
| `role__v.users` | A string of user `id` values to remove. |
| `role__v.groups` | A string of group `id` values to remove. |
</FieldTable>
For example,

<FieldTable>
| `id` | `reviewer__v.users` | `reviewer__v.groups` | `approver__v.users` | `approver__v.groups` |
| --- | --- | --- | --- | --- |
| 771 | "12021,12022" | "3311303,3311404" | 22124 | 4411606 |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X DELETE -H "Authorization: {SESSION_ID}" \
-H "Content-Type: text/csv" \
-H "Accept: application/json" \
--data-binary @"C:\Vault\Document Roles\remove_document_roles.csv" \
https://myvault.veevavault.com/api/v23.2/objects/documents/roles/batch

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS",
            "id": 5,
            "coordinator__v.users": [
                1008313
            ],
            "consumer__v.users": [
                1006595
            ]
        }
    ]
}

```
</CodeExample>

## Response Details {#response-details}

On SUCCESS, the response lists the IDs of the users or groups removed from the provided document roles. On FAILURE, the response returns an error message describing the reason for the failure. For example, a user or group may not be removed if the role assignment is system-managed.



---

**Previous:** [Remove Users & Groups from Roles on a Single Document](/safety/vault-api/api-reference/23.3/document-roles/remove-users-groups-from-roles-on-a-single-document)  
**Next:** [Workflows](/safety/vault-api/api-reference/23.3/workflows)