---
title: "Upgrade a mixed document"
method: POST
path: "/v1/document/mixed/upgrade"
tags: ["File Commands"]
---

# Upgrade a mixed document

`POST /v1/document/mixed/upgrade`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v1/document/mixed/upgrade`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

Change the processing type of a Mixed Document from Classify to Instant, or from Instant to Complete, without changing the Book's `book_class`.

Use this endpoint for mixed PDF uploads when only that mixed document needs a higher processing tier and you want new uploads to continue following the Book's current class.

For single (non-mixed) documents, use the [Upgrade a document](https://docs.ocrolus.com/reference/upgrade-doc) endpoint. For Book-level class changes, use the [Book Upgrades](https://docs.ocrolus.com/docs/book-upgrade) and [Update Book](https://docs.ocrolus.com/reference/update-book) endpoint.

### Prerequisites

- Document-level upgrades must be enabled for your organization. If not, contact your Ocrolus account manager.
- The mixed document must finish its current processing before you upgrade it.
- Do not upgrade child documents individually. Upgrade the mixed document with this endpoint.
- If the Book is already Complete, or a Book upgrade already covers the same target, the mixed document upgrade is rejected.
- On success, the mixed document re-enters processing under the new tier. Re-fetch status and Capture or Analyze data after verification completes.

### When to use this endpoint

| Scenario | Use this endpoint? |
|---|---|
| An Instant mixed document needs Complete accuracy | Yes - `upgrade_type: COMPLETE` |
| A classified mixed document needs Instant capture (Book class is `INSTANT_CLASSIFY_ONLY` or `INSTANT_CLASSIFY_ISO_CAPTURE`) | Yes - `upgrade_type: INSTANT` |
| The file is a single (non-mixed) document | No - use [Upgrade a document](https://docs.ocrolus.com/reference/upgrade-doc) |
| The entire Book should move to Complete | No - use [Update Book](https://docs.ocrolus.com/reference/update-book) |

### Upgrade types

| `upgrade_type` | Meaning |
|---|---|
| `INSTANT` | Upgrade from Classify to Instant capture |
| `COMPLETE` | Upgrade from Classify or Instant to Complete |

Mixed document upgrades are **forward-only**. You cannot downgrade from Complete back to Instant.

## Request body

- object
  - `mixed_doc_pk` string: The <<glossary:PK>> of the <<glossary:Document>> that will be upgraded. Mutually exclusive with `mixed_doc_uuid`.
  - `mixed_doc_uuid` integer: The universal unique identifier of the <<glossary:Document>> that will be upgraded. Mutually exclusive with `mixed_doc_pk`.
  - `upgrade_type` 'INSTANT' | 'COMPLETE': The type of processing to upgrade the <<glossary:Document>> to.

## Response `200`

Success

- object
  - `status` integer: A numerical code that indicates the status of the request.
  - `response` object: An object received from the server that potentially contains data.
    - `pk` integer: The <<glossary:PK>> of the Mixed Document that will be upgraded.
    - `uuid` string: The universal unique identifier of the Mixed Document that will be upgraded.
    - `name` string: The name of the Mixed Document that will be upgraded.
    - `document_status` string: The verification status of the Mixed Document.
    - `book_pk` integer: The <<glossary:PK>> of the <<glossary:Book>> that this Mixed Document is uploaded to.
    - `processing_type` string: The type of processing to upgrade the Mixed Document to. (INSTANT/COMPLETE)

## Other responses

- `400`: Client Errors
- `500`: Internal server error

---

[API](https://skmtc.dev/ocrolus/apis/file-commands.md) - [All operations](https://skmtc.dev/ocrolus/apis/file-commands/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/file-commands/revisions/387371d96db7?raw)