---
title: "Changes to Update an organization"
method: PATCH
path: "/v3/organizations/{identifier}"
---

# Changes to Update an organization

`PATCH /v3/organizations/{identifier}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 14 revisions.

- **2026-06-14** `acca5642c0bc`: 9 info
- **2025-11-20** `978cf99a2ac0`: 8 info
- **2024-03-04** `c3123d7b7301`: 3 breaking, 4 warning, 14 info

## Changes

- **2026-06-14** `acca5642c0bc`: 9 info
  - the response property `avatar` became required for the status `200`
  - the response property `identifier` became required for the status `200`
  - the response property `isTrial` became required for the status `200`
  - the response property `name` became required for the status `200`
  - the response property `resthookSignatureKey` became required for the status `200`
  - the response property `showCustomFieldCreation` became required for the status `200`
  - the response property `userRole` became required for the status `200`
  - the response property `validationToolConfig` became required for the status `200`
  - added the required property `allowDataSourceRecordCreation` to the response with the `200` status
- **2025-11-20** `978cf99a2ac0`: 8 info
  - api tag `Add x-hidden to endpoints` added
  - api tag `Organization API - Organization` removed
  - added the new optional request property `validationToolConfig/disableManualAnnotationEditing`
  - added the new optional request property `validationToolConfig/hideDocumentStatus`
  - added the new optional request property `validationToolConfig/hideShowRawValues`
  - added the optional property `validationToolConfig/disableManualAnnotationEditing` to the response with the `200` status
  - added the optional property `validationToolConfig/hideDocumentStatus` to the response with the `200` status
  - added the optional property `validationToolConfig/hideShowRawValues` to the response with the `200` status
- **2024-03-04** `c3123d7b7301`: 3 breaking, 4 warning, 14 info
  - response property `validationToolConfig/theme/typography/fontSize` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - added `subschema #1, subschema #2` to the `validationToolConfig/theme/palette/background` response property `oneOf` list for the response status `200`
  - the `validationToolConfig/theme/palette/background` response's property type changed from `object` to no type for status `200`
  - removed the request property `validationToolConfig/theme/palette/background/default`
  - removed the request property `validationToolConfig/theme/palette/background/paper`
  - removed the optional property `validationToolConfig/theme/palette/background/default` from the response with the `200` status
  - removed the optional property `validationToolConfig/theme/palette/background/paper` from the response with the `200` status
  - added the new optional request property `validationToolConfig/disableEditDocumentMetadata`
  - added the new optional request property `validationToolConfig/hideEditPages`
  - added the new optional request property `validationToolConfig/hideReject`
  - added the new optional request property `validationToolConfig/hideReparse`
  - added the new optional request property `validationToolConfig/hideRunOcr`
  - request property `validationToolConfig/theme/typography/fontSize` list-of-types was widened by adding types `number` to media type `multipart/form-data`
  - added `subschema #1, subschema #2` to the `validationToolConfig/theme/palette/background` request property `oneOf` list
  - the `validationToolConfig/theme/palette/background` request property type was generalized from `object` to no type
  - added the optional property `showCustomFieldCreation` to the response with the `200` status
  - added the optional property `validationToolConfig/disableEditDocumentMetadata` to the response with the `200` status
  - added the optional property `validationToolConfig/hideEditPages` to the response with the `200` status
  - added the optional property `validationToolConfig/hideReject` to the response with the `200` status
  - added the optional property `validationToolConfig/hideReparse` to the response with the `200` status
  - added the optional property `validationToolConfig/hideRunOcr` to the response with the `200` status

---

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