---
title: "Changes to Create a annotation"
method: POST
path: "/v3/annotations"
---

# Changes to Create a annotation

`POST /v3/annotations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 14 revisions.

- **2025-11-20** `978cf99a2ac0`: 2 info
- **2025-07-23** `0913ed9391cb`: 1 breaking, 3 info
- **2025-04-30** `b5be3a151d19`: 1 warning
- **2024-06-12** `9b7d1081f5bc`: 4 breaking, 4 info
- **2024-03-04** `c3123d7b7301`: 14 breaking, 2 warning, 3 info

## Changes

- **2025-11-20** `978cf99a2ac0`: 2 info
  - api tag `Annotations` added
  - api tag `Document API - Annotation` removed
- **2025-07-23** `0913ed9391cb`: 1 breaking, 3 info
  - the response property `allOf[#/components/schemas/Annotation]/dataPoint` became optional for the status `201`
  - added the new optional request property `field`
  - the request property `dataPoint` became optional
  - added the optional property `allOf[#/components/schemas/Annotation]/field` to the response with the `201` status
- **2025-04-30** `b5be3a151d19`: 1 warning
  - added the new `docclf` enum value to the `allOf[#/components/schemas/Annotation]/contentType` response property for the response status `201`
- **2024-06-12** `9b7d1081f5bc`: 4 breaking, 4 info
  - added the new required request property `validationResults/items/created/items/document`
  - added the new required request property `validationResults/items/deleted/items/document`
  - added the new required request property `validationResults/items/updated/items/document`
  - the response property `allOf[subschema #2]/validationResults/items/passed` became nullable for the status `201`
  - the request property `validationResults/items/created/items/passed` became nullable
  - the request property `validationResults/items/deleted/items/passed` became nullable
  - the request property `validationResults/items/updated/items/passed` became nullable
  - added the required property `allOf[subschema #2]/validationResults/items/document` to the response with the `201` status
- **2024-03-04** `c3123d7b7301`: 14 breaking, 2 warning, 3 info
  - the request property `rectangles` became not nullable
  - removed the required property `classificationConfidence` from the response with the `201` status
  - removed the required property `confidence` from the response with the `201` status
  - removed the required property `contentType` from the response with the `201` status
  - removed the required property `dataPoint` from the response with the `201` status
  - removed the required property `id` from the response with the `201` status
  - removed the required property `isAutoVerified` from the response with the `201` status
  - removed the required property `isClientVerified` from the response with the `201` status
  - removed the required property `isVerified` from the response with the `201` status
  - removed the required property `pageIndex` from the response with the `201` status
  - removed the required property `raw` from the response with the `201` status
  - removed the required property `rectangle` from the response with the `201` status
  - removed the required property `rectangles` from the response with the `201` status
  - removed the required property `textExtractionConfidence` from the response with the `201` status
  - the `pageIndex` request property's min was set to `0.00`
  - removed the optional property `document` from the response with the `201` status
  - added the new optional request property `rectangles/items/pageIndex`
  - added the new optional request property `validationResults`
  - added `#/components/schemas/Annotation, subschema #2` to the response body `allOf` list for the response status `201`

---

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