File Commands

Upgrade a mixed document

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 endpoint. For Book-level class changes, use the Book Upgrades and 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

ScenarioUse this endpoint?
An Instant mixed document needs Complete accuracyYes - 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) documentNo - use Upgrade a document
The entire Book should move to CompleteNo - use Update Book

Upgrade types

upgrade_typeMeaning
INSTANTUpgrade from Classify to Instant capture
COMPLETEUpgrade from Classify or Instant to Complete

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

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

Request body

mixed_doc_pkstring

The <glossary:PK> of the <glossary:Document> that will be upgraded. Mutually exclusive with mixed_doc_uuid.

mixed_doc_uuidinteger

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

Success

statusinteger

A numerical code that indicates the status of the request.

Example response

{
  "status": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.