**Source URL:** https://limited.veevavault.dev/sitevault/vault-api/api-reference/24.1/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](/sitevault/vault-api/api-reference/24.1/document-roles/remove-users-groups-from-roles-on-a-single-document)  
**Next:** [Workflows](/sitevault/vault-api/api-reference/24.1/workflows)