**Source URL:** https://limited.veevavault.dev/quality/vault-api/api-reference/23.3/documents/update-documents/reclassify-single-document.md

# Reclassify Single Document



Reclassify allows you to change the document type of an existing document or assign a document type to an unclassified document. This endpoint is analogous to the *Reclassify* action in the Vault UI.

A document "type" is the combination of the `type__v`, `subtype__v`, and `classification__v` fields on a document. When you reclassify, Vault may add or remove certain fields on the document. Add these new fields and values to the body of this request. If a new required field is missing, the error response will list the name of the required field. To reclassify more than one document, use the [Reclassify Multiple Documents](/vault-api/api-reference/23.3/documents/update-documents/reclassify-multiple-documents) endpoint.

Not all documents are eligible for reclassification. For example, you can only reclassify the latest version of a document and you cannot reclassify a checked out document. Learn more about [reclassifying documents in Vault Help](https://platform.veevavault.help/en/lr/2271).

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

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |
| `X-VaultAPI-MigrationMode` | When set to `true`, use with the `status__v` and `document_number__v` body parameters to reclassify documents to any document lifecycle state and with any document number. 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>

## URI Path Parameters {#uri-path-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `{doc_id}` | The document `id` field value. |
</FieldTable>

## Body Parameters {#body-parameters}

You can also add or remove values for any other editable document field. Note that additional fields may be required depending on the document type, subtype, and classification being assigned to the document. Use the [Document Metadata API](/vault-api/api-reference/23.3/documents/retrieve-document-fields/retrieve-all-document-fields) to retrieve required and editable fields in your Vault. If a required field is missing, the error response will list the name of the required field.

## Request {#request}

<CodeExample title="">
```
curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "reclassify=true" \
-d "type__v=Promotional Piece" \
-d "subtype__v=Advertisement" \
-d "classification__v=Web" \
-d "lifecycle__v=Promotional Piece" \
https://myvault.veevavault.com/api/v15.0/objects/documents/775

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
   "responseStatus": "SUCCESS",
   "id": 775
}

```
</CodeExample>

---

**Previous:** [Update Multiple Documents](/quality/vault-api/api-reference/23.3/documents/update-documents/update-multiple-documents)  
**Next:** [Reclassify Multiple Documents](/quality/vault-api/api-reference/23.3/documents/update-documents/reclassify-multiple-documents)