**Source URL:** https://limited.veevavault.dev/sitevault/vault-api/api-reference/19.1/documents/delete-documents/delete-multiple-documents.md

# Delete Multiple Documents



Delete all versions of multiple documents, including all source files and viewable renditions.

* The maximum input file size is 1GB.

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

* CSVs must follow the [standard format.](http://tools.ietf.org/html/rfc4180)

* The maximum batch size is 500.

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

## Headers {#headers}

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

## Body Parameters {#body-parameters}

<Aside>Some HTTP clients do not support `DELETE` requests with a
body. As a workaround for these cases, you can simulate this request using the
`POST` method with the `_method=DELETE` query parameter.

</Aside>
Create a CSV or JSON input file. Choose one of the following two ways to identify documents for deletion:

<FieldTable>
| Name | Description |
| --- | --- |
| `id` | The system-assigned document ID of the document to delete. |
| `external_id__v` | Optional: Instead of `id`, you can use this user-defined document external ID. |
</FieldTable>

## Query Parameters {#query-parameters}

## Request {#request}

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

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS",
            "id": 771,
            "external_id__v": "ALT-DOC-0771"
        },
        {
            "responseStatus": "SUCCESS",
            "id": 772,
            "external_id__v": "CHO-DOC-0772"
        },
        {
            "responseStatus": "SUCCESS",
            "id": 773,
            "external_id__v": "GLU-DOC-0773"
        },
        {
            "responseStatus": "FAILURE",
            "errors": [
                {
                    "type": "INVALID_DATA",
                    "message": "Error message describing why this document was not deleted."
                }
            ]
        }
    ]
}

```
</CodeExample>

---

**Previous:** [Delete Single Document](/sitevault/vault-api/api-reference/19.1/documents/delete-documents/delete-single-document)  
**Next:** [Delete Single Document Version](/sitevault/vault-api/api-reference/19.1/documents/delete-documents/delete-single-document-version)