**Source URL:** https://limited.veevavault.dev/regulatory/vault-api/api-reference/26.1/documents/document-renditions/delete-multiple-document-renditions

# Delete Multiple Document Renditions

Delete document renditions in bulk.

*   The maximum 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](/regulatory/vault-api/references/csv-rfc-deviations).
*   The maximum batch size is 500.

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

## Headers

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

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

<FieldTable>
| Name | Description |
| --- | --- |
| `id`<Requiredness type="conditional" /> | The system-assigned document ID of the document to delete. Not required if providing a unique field identifier (`idParam`) such as `external_id__v`. |
| `external_id__v`<Requiredness type="conditional" /> | Instead of `id`, you can use this user-defined document external ID. |
| `rendition_type__v`<Requiredness type="required" /> | Rendition type to delete from the document. |
| `major_version_number__v`<Requiredness type="required" /> | Major version number of the document rendition to remove. |
| `minor_version_number__v`<Requiredness type="required" /> | Minor version number of the document rendition to remove. |
</FieldTable>

## Query Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `idParam` | If you're identifying documents in your input by a unique field, add `idParam={fieldname}` to the request endpoint. You can use any object field which has `unique` set to `true` in the object metadata, with the exception of picklists. For example, `idParam=external_id__v`. |
</FieldTable>

## Request

<CodeExample title="">
```bash
curl -X DELETE -H "Authorization: {SESSION_ID}" \
-H "Content-Type: text/csv" \
-H "Accept: text/csv" \
--data-raw 'id,rendition_type__v,major_version_number__v,minor_version_number__v
771,imported_rendition__c,0,2
772,imported_rendition__c,0,2
773,imported_rendition__c,1,0
774,imported_rendition__c,1,1' \
https://myvault.veevavault.com/api/v13.0/objects/documents/renditions/batch
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
    "responseStatus": "SUCCESS",
    "data": [
        {
            "responseStatus": "SUCCESS",
            "id": 771,
            "external_id__v": "ALT-DOC-0771",
            "major_version_number__v": 0,
            "minor_version_number__v": 2,
            "rendition_type__c": "imported_rendition__c"
        },
        {
            "responseStatus": "SUCCESS",
            "id": 772,
            "external_id__v": "CHO-DOC-0772",
            "major_version_number__v": 0,
            "minor_version_number__v": 2,
            "rendition_type__c": "imported_rendition__c"
        },
        {
            "responseStatus": "SUCCESS",
            "id": 773,
            "external_id__v": "GLU-DOC-0773",
            "major_version_number__v": 1,
            "minor_version_number__v": 0,
            "rendition_type__c": "imported_rendition__c"
        },
        {
            "responseStatus": "FAILURE",
            "errors": [
                {
                    "type": "INVALID_DATA",
                    "message": "Error message describing why this document rendition was not added."
                }
            ]
        }
    ]
}
```
</CodeExample>

---

**Previous:** [Replace Document Version Rendition](/regulatory/vault-api/api-reference/26.1/documents/document-renditions/replace-document-version-rendition)  
**Next:** [Delete Single Document Rendition](/regulatory/vault-api/api-reference/26.1/documents/document-renditions/delete-single-document-rendition)