**Source URL:** https://limited.veevavault.dev/medical/vault-api/api-reference/20.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,

## Request {#request}

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

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS",
            "id": 771,
            "reviewer__v.groups": [
                4411606
            ],
            "reviewer__v.users": [
                12124
            ]
        },
        {
            "responseStatus": "SUCCESS",
            "id": 772,
            "reviewer__v.groups": [
                4411606
            ],
            "reviewer__v.users": [
                12124
            ]
        },
        {
           "responseStatus":"FAILURE",
           "id":"773",
           "errors":[
              {
                 "type":"INVALID_DATA",
                 "message":"Error message describing why the users and groups were not removed from roles on this document."
              }
           ]
        }
    ]
}

```
</CodeExample>

---

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