---
title: "Changes to OCR"
method: POST
path: "/v1/ocr"
---

# Changes to OCR

`POST /v1/ocr`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 14 revisions.

- **2026-08-14** `61436a496404`: 14 info
- **2026-07-26** `933c4ebdcd72`: 1 info
- **2026-07-13** `5a5c361558bb`: 1 warning, 3 info
- **2026-05-14** `2ef5e2e4ab99`: 3 info
- **2026-04-07** `ff8a7389b7a4`: 5 breaking, 3 info
- **2026-03-01** `37659aafcad6`: 1 info
- **2026-01-24** `0389594a7ee6`: 7 info

## Changes

- **2026-08-14** `61436a496404`: 14 info
  - added the new `block` enum value to the request property `confidence_scores_granularity/anyOf[subschema #1]/`
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #10: OCRAsideTextBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #11: OCRHeaderBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #12: OCRFooterBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #13: OCRSignatureBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #1: OCRTextBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #2: OCRListBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #3: OCRImageBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #4: OCRTableBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #5: OCRTitleBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #6: OCREquationBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #7: OCRCaptionBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #8: OCRCodeBlock]/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/blocks/anyOf[subschema #1]/items/oneOf[subschema #9: OCRReferencesBlock]/confidence_scores` to the response with the `200` status
- **2026-07-26** `933c4ebdcd72`: 1 info
  - the `include_blocks` request property default value changed from `false` to `true`
- **2026-07-13** `5a5c361558bb`: 1 warning, 3 info
  - removed the request property `id`
  - added the new optional request property `include_blocks`
  - request property `pages` list-of-types was widened by adding types `string` to media type `application/json`
  - added the optional property `pages/items/blocks` to the response with the `200` status
- **2026-05-14** `2ef5e2e4ab99`: 3 info
  - added the new optional request property `confidence_scores_granularity`
  - added the optional property `pages/items/confidence_scores` to the response with the `200` status
  - added the optional property `pages/items/tables/items/word_confidence_scores` to the response with the `200` status
- **2026-04-07** `ff8a7389b7a4`: 5 breaking, 3 info
  - removed `subschema #1` from the `document/anyOf[subschema #3: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` request property `anyOf` list
  - the `type` request property const value `document_url` was added
  - the `type` request property const value `image_url` was added
  - removed the enum value `document_url` of the request property `document/anyOf[subschema #2: DocumentURLChunk]/type`
  - removed the enum value `image_url` of the request property `document/anyOf[subschema #3: ImageURLChunk]/type`
  - api tag `ocr` added
  - added `#/components/schemas/ImageDetail` to the `document/anyOf[subschema #3: ImageURLChunk]/image_url/anyOf[subschema #1: ImageURL]/detail` request property `anyOf` list
  - added the non-success response with the status `422`
- **2026-03-01** `37659aafcad6`: 1 info
  - added the new optional request property `document_annotation_prompt`
- **2026-01-24** `0389594a7ee6`: 7 info
  - added the new optional request property `extract_footer`
  - added the new optional request property `extract_header`
  - added the new optional request property `table_format`
  - added the optional property `pages/items/footer` to the response with the `200` status
  - added the optional property `pages/items/header` to the response with the `200` status
  - added the optional property `pages/items/hyperlinks` to the response with the `200` status
  - added the optional property `pages/items/tables` to the response with the `200` status

---

[Operation](https://skmtc.dev/mistral/apis/mistral-ai-api/docs/v1/ocr/post.md) - [API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) - [Page](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/ocr/post)