---
title: "Changes to Update an annotation"
method: PATCH
path: "/v3/annotations/{id}"
---

# Changes to Update an annotation

`PATCH /v3/annotations/{id}`

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

---

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