---
title: "Changes to Batch update annotations"
method: POST
path: "/v3/annotations/batch_update"
---

# Changes to Batch update annotations

`POST /v3/annotations/batch_update`

> 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`: 2 breaking, 1 warning, 9 info
- **2024-03-04** `c3123d7b7301`: 2 breaking, 7 warning, 9 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 `items/dataPoint` became optional for the status `200`
  - added the new optional request property `items/parsed/oneOf[subschema #6]/items/field`
  - the request property `items/parsed/oneOf[subschema #6]/items/dataPoint` became optional
  - added the optional property `items/field` to the response with the `200` status
- **2025-04-30** `b5be3a151d19`: 1 warning
  - added the new `docclf` enum value to the `items/contentType` response property for the response status `200`
- **2024-06-12** `9b7d1081f5bc`: 2 breaking, 1 warning, 9 info
  - added the new required request property `items/id`
  - the `items/` request property type changed from no type to `object`
  - removed `#/components/schemas/AnnotationUpdate, subschema #1` from the `items/` request property `allOf` list
  - added the new optional request property `items/dataPoint`
  - added the new optional request property `items/document`
  - added the new optional request property `items/isClientVerified`
  - added the new optional request property `items/pageIndex`
  - added the new optional request property `items/parent`
  - added the new optional request property `items/parsed`
  - added the new optional request property `items/raw`
  - added the new optional request property `items/rectangles`
  - added the new optional request property `items/validationResults`
- **2024-03-04** `c3123d7b7301`: 2 breaking, 7 warning, 9 info
  - the request property `items/allOf[#/components/schemas/AnnotationUpdate]/parsed/oneOf[subschema #6]/items/rectangles` became not nullable
  - the request property `items/allOf[#/components/schemas/AnnotationUpdate]/rectangles` became not nullable
  - the `items/allOf[#/components/schemas/AnnotationUpdate]/pageIndex` request property's min was set to `0.00`
  - the `items/allOf[#/components/schemas/AnnotationUpdate]/parsed/oneOf[subschema #6]/items/pageIndex` request property's min was set to `0.00`
  - the `items/allOf[subschema #1]/id` request property's min was set to `1.00`
  - added the new `daterange` enum value to the `items/contentType` response property for the response status `200`
  - added the new `image` enum value to the `items/contentType` response property for the response status `200`
  - added the new `phonenumber` enum value to the `items/contentType` response property for the response status `200`
  - added the new `url` enum value to the `items/contentType` response property for the response status `200`
  - added the new optional request property `items/allOf[#/components/schemas/AnnotationUpdate]/parsed/oneOf[subschema #6]/items/rectangles/items/pageIndex`
  - added the new optional request property `items/allOf[#/components/schemas/AnnotationUpdate]/parsed/oneOf[subschema #6]/items/validationResults`
  - added the new optional request property `items/allOf[#/components/schemas/AnnotationUpdate]/rectangles/items/pageIndex`
  - added the new optional request property `items/allOf[#/components/schemas/AnnotationUpdate]/validationResults`
  - added the optional property `items/parent` to the response with the `200` status
  - added the optional property `items/rectangle/pageIndex` to the response with the `200` status
  - added the optional property `items/rectangles/items/pageIndex` to the response with the `200` status
  - the response property `items/document` became required for the status `200`
  - removed the `cell` enum value from the `items/contentType` response property for the response status `200`

---

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