---
title: "Changes to Upload a document for parsing"
method: POST
path: "/v3/documents"
---

# Changes to Upload a document for parsing

`POST /v3/documents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 14 revisions.

- **2026-01-20** `86b6b449b1f3`: 1 info
- **2025-11-20** `978cf99a2ac0`: 2 breaking, 1 warning, 5 info
- **2025-07-23** `0913ed9391cb`: 35 info
- **2025-04-30** `b5be3a151d19`: 26 info
- **2025-01-20** `b1a28fe2c32d`: 2 info
- **2024-09-12** `98132617d3e3`: 6 info
- **2024-06-12** `9b7d1081f5bc`: 1 info
- **2024-03-04** `c3123d7b7301`: 51 breaking, 43 warning, 143 info

## Changes

- **2026-01-20** `86b6b449b1f3`: 1 info
  - added the new optional request property `limitToExamples`
- **2025-11-20** `978cf99a2ac0`: 2 breaking, 1 warning, 5 info
  - the response property `meta/collection/extractor` became nullable for the status `200`
  - the response property `meta/collection/extractor` became nullable for the status `201`
  - removed the request property `data`
  - api tag `Documents` added
  - api tag `Document API - Document` removed
  - added the new optional request property `llmHint`
  - added the optional property `meta/llmHint` to the response with the `200` status
  - added the optional property `meta/llmHint` to the response with the `201` status
- **2025-07-23** `0913ed9391cb`: 35 info
  - added the new optional `query` request parameter `snake_case`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/endDate/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/expectedRemuneration/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobTitle/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobType/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/languages/items/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/location/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationName/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationWebsite/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/skills/items/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/startDate/allOf[#/components/schemas/Annotation]/field`
  - added the new optional request property `data/oneOf[#/components/schemas/JobDescriptionData]/yearsExperience/allOf[#/components/schemas/Annotation]/field`
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/endDate/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/expectedRemuneration/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobTitle/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobType/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/languages/items/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/location/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationName/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationWebsite/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/skills/items/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/startDate/allOf[#/components/schemas/Annotation]/dataPoint` became optional
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/yearsExperience/allOf[#/components/schemas/Annotation]/dataPoint` became optional
- **2025-04-30** `b5be3a151d19`: 26 info
  - added the new optional request property `documentType`
  - added the new `Bahasa Indonesian` enum value to the request property `data/oneOf[#/components/schemas/ResumeData]/languages/items/`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/endDate/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/expectedRemuneration/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobTitle/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobType/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/languages/items/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/location/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationName/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationWebsite/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/skills/items/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/startDate/allOf[#/components/schemas/Annotation]/contentType`
  - added the new `docclf` enum value to the request property `data/oneOf[#/components/schemas/JobDescriptionData]/yearsExperience/allOf[#/components/schemas/Annotation]/contentType`
  - added the non-success response with the status `403`
  - added the optional property `meta/archivedBy` to the response with the `200` status
  - added the optional property `meta/archivedBy` to the response with the `201` status
  - added the optional property `meta/collection/autoRefreshValidationResults` to the response with the `200` status
  - added the optional property `meta/collection/autoRefreshValidationResults` to the response with the `201` status
  - added the optional property `meta/documentType` to the response with the `200` status
  - added the optional property `meta/documentType` to the response with the `201` status
- **2025-01-20** `b1a28fe2c32d`: 2 info
  - added the new optional request property `useOcr`
  - added the new optional request property `warningMessages`
- **2024-09-12** `98132617d3e3`: 6 info
  - added the optional property `meta/childDocuments/items/customIdentifier` to the response with the `200` status
  - added the optional property `meta/childDocuments/items/customIdentifier` to the response with the `201` status
  - added the optional property `meta/html` to the response with the `200` status
  - added the optional property `meta/html` to the response with the `201` status
  - added the optional property `meta/parentDocument/customIdentifier` to the response with the `200` status
  - added the optional property `meta/parentDocument/customIdentifier` to the response with the `201` status
- **2024-06-12** `9b7d1081f5bc`: 1 info
  - added the new optional request property `enableValidationTool`
- **2024-03-04** `c3123d7b7301`: 51 breaking, 43 warning, 143 info
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/endDate/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/expectedRemuneration/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobTitle/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobType/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/languages/items/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/location/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationName/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationWebsite/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/skills/items/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/startDate/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/yearsExperience/allOf[#/components/schemas/Annotation]/rectangles` became not nullable
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/endDate/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/expectedRemuneration/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobTitle/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/jobType/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/languages/items/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/location/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationName/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/organizationWebsite/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/skills/items/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/startDate/allOf[#/components/schemas/Annotation]/document` became required
  - the request property `data/oneOf[#/components/schemas/JobDescriptionData]/yearsExperience/allOf[#/components/schemas/Annotation]/document` became required
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/certifications/items/allOf[#/components/schemas/Annotation]/contentType`
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactEmail/allOf[#/components/schemas/Annotation]/contentType`
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactName/allOf[#/components/schemas/Annotation]/contentType`
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/contactPhone/allOf[#/components/schemas/Annotation]/contentType`
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationAccreditation/allOf[#/components/schemas/Annotation]/contentType`
  - removed the enum value `cell` of the request property `data/oneOf[#/components/schemas/JobDescriptionData]/educationLevel/allOf[#/components/schemas/Annotation]/contentType`
  - …197 more

---

[Operation](https://skmtc.dev/affinda/apis/affinda-api-2/docs/v3/documents/post.md) - [API](https://skmtc.dev/affinda/apis/affinda-api-2.md) - [Page](https://skmtc.dev/affinda/apis/affinda-api-2/changes/v3/documents/post)
