**Source URL:** https://limited.veevavault.dev/qualityone/vault-api/api-reference/24.2/documents/update-documents/update-multiple-documents.md

# Update Multiple Documents



Bulk update editable field values on multiple documents. You can only update the latest version of each document. To update past document versions, see [Update Document Version](/vault-api/api-reference/24.2/documents/update-documents/update-document-version).

* 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 1,000.

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

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `text/csv` or `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `text/csv` |
| `X-VaultAPI-MigrationMode` | When set to `true`, Vault allows you to change the document number. All other Document Migration Mode overrides available at document creation are ignored, but do not generate an error message. You must have the *Document Migration* permission to use this header. Learn more about [Document Migration Mode in Vault Help](https://platform.veevavault.help/en/lr/54028). |
</FieldTable>

## Body Parameters {#body-parameters}

You can use Name-Value pairs in the body of your request or upload a CSV file. `id` is the only required field, and you can update values of any editable document field. To find these fields, [Retrieve Document Fields](/vault-api/api-reference/24.2/documents/retrieve-document-fields/retrieve-all-document-fields) configured on documents. Editable fields will have `editable:true`. To remove existing field values, include the field name and set its value to null.

The following table includes required fields, and some optional document fields you may want to update:

<FieldTable>
| Name | Description |
| --- | --- |
| `id` | The ID of the document to update. Only required when uploading a CSV file. |
| `docIds` | Comma-separated list of the IDs of documents to update. Only required when entering key-value pairs in the body of your request. |
| `archive__v` | To archive a document, set to `true`. To unarchive a document, set to `false`. The default is `false`. Document archive is not available in all Vaults. [Learn more in Vault Help.](https://platform.veevavault.help/en/lr/34126) |
|  |  |
| `template_doctype__v` | If you need to create a controlled document template from this document, enter a value for the *Template Document Type* field. To retrieve a list of all possible field values for this field, [Retrieve the Object Collection](/vault-api/api-reference/24.2/vault-objects/retrieve-object-record-collection) for `doc_type_detail__v`. Learn more about [controlled document template creation in Vault Help](https://platform.veevavault.help/en/lr/46025). |
</FieldTable>
<DownloadButton href="/sample-files/vault-update-documents-sample-csv-input.csv" label="Download Input File"></DownloadButton>

## Request {#request}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: text/csv" \
-H "Accept: text/csv" \
--data-binary @"filename" \
https://myvault.veevavault.com/api/v9.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"
        }
    ]
}

```
</CodeExample>

---

**Previous:** [Update Single Document](/qualityone/vault-api/api-reference/24.2/documents/update-documents/update-single-document)  
**Next:** [Reclassify Single Document](/qualityone/vault-api/api-reference/24.2/documents/update-documents/reclassify-single-document)