---
title: "Changes to Create a collection"
method: POST
path: "/v3/collections"
---

# Changes to Create a collection

`POST /v3/collections`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 14 revisions.

- **2026-06-14** `acca5642c0bc`: 18 info
- **2025-11-20** `978cf99a2ac0`: 1 breaking, 8 info
- **2025-07-23** `0913ed9391cb`: 1 info
- **2025-04-30** `b5be3a151d19`: 6 warning, 6 info
- **2024-09-12** `98132617d3e3`: 11 info
- **2024-06-12** `9b7d1081f5bc`: 8 info
- **2024-03-04** `c3123d7b7301`: 11 breaking, 4 warning, 84 info

## Changes

- **2026-06-14** `acca5642c0bc`: 18 info
  - the response property `extractor/organization/avatar` became required for the status `201`
  - the response property `extractor/organization/identifier` became required for the status `201`
  - the response property `extractor/organization/isTrial` became required for the status `201`
  - the response property `extractor/organization/name` became required for the status `201`
  - the response property `extractor/organization/resthookSignatureKey` became required for the status `201`
  - the response property `extractor/organization/showCustomFieldCreation` became required for the status `201`
  - the response property `extractor/organization/userRole` became required for the status `201`
  - the response property `extractor/organization/validationToolConfig` became required for the status `201`
  - the response property `workspace/organization/avatar` became required for the status `201`
  - the response property `workspace/organization/identifier` became required for the status `201`
  - the response property `workspace/organization/isTrial` became required for the status `201`
  - the response property `workspace/organization/name` became required for the status `201`
  - the response property `workspace/organization/resthookSignatureKey` became required for the status `201`
  - the response property `workspace/organization/showCustomFieldCreation` became required for the status `201`
  - the response property `workspace/organization/userRole` became required for the status `201`
  - the response property `workspace/organization/validationToolConfig` became required for the status `201`
  - added the required property `extractor/organization/allowDataSourceRecordCreation` to the response with the `201` status
  - added the required property `workspace/organization/allowDataSourceRecordCreation` to the response with the `201` status
- **2025-11-20** `978cf99a2ac0`: 1 breaking, 8 info
  - the response property `extractor` became nullable for the status `201`
  - api tag `Deprecated End Points` added
  - api tag `Document API - Collection` removed
  - added the optional property `extractor/organization/validationToolConfig/disableManualAnnotationEditing` to the response with the `201` status
  - added the optional property `extractor/organization/validationToolConfig/hideDocumentStatus` to the response with the `201` status
  - added the optional property `extractor/organization/validationToolConfig/hideShowRawValues` to the response with the `201` status
  - added the optional property `workspace/organization/validationToolConfig/disableManualAnnotationEditing` to the response with the `201` status
  - added the optional property `workspace/organization/validationToolConfig/hideDocumentStatus` to the response with the `201` status
  - added the optional property `workspace/organization/validationToolConfig/hideShowRawValues` to the response with the `201` status
- **2025-07-23** `0913ed9391cb`: 1 info
  - endpoint deprecated
- **2025-04-30** `b5be3a151d19`: 6 warning, 6 info
  - added the new `docclf` enum value to the `extractor/fieldGroups/items/fields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the `fields/items/fields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the `fieldsLayout/categories/items/disabledFields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the `fieldsLayout/categories/items/enabledFields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the `fieldsLayout/defaultCategory/disabledFields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the `fieldsLayout/defaultCategory/enabledFields/items/fieldType` response property for the response status `201`
  - added the new `docclf` enum value to the request property `fields/items/fields/items/fieldType`
  - added the new `docclf` enum value to the request property `fieldsLayout/categories/items/disabledFields/items/fieldType`
  - added the new `docclf` enum value to the request property `fieldsLayout/categories/items/enabledFields/items/fieldType`
  - added the new `docclf` enum value to the request property `fieldsLayout/defaultCategory/disabledFields/items/fieldType`
  - added the new `docclf` enum value to the request property `fieldsLayout/defaultCategory/enabledFields/items/fieldType`
  - added the optional property `autoRefreshValidationResults` to the response with the `201` status
- **2024-09-12** `98132617d3e3`: 11 info
  - added the new optional request property `enableAutoValidationThreshold`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/enableAutoValidationThreshold`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/enableAutoValidationThreshold`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/enableAutoValidationThreshold`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/enableAutoValidationThreshold`
  - added the optional property `enableAutoValidationThreshold` to the response with the `201` status
  - added the optional property `fieldsLayout/categories/items/disabledFields/items/enableAutoValidationThreshold` to the response with the `201` status
  - added the optional property `fieldsLayout/categories/items/enabledFields/items/enableAutoValidationThreshold` to the response with the `201` status
  - added the optional property `fieldsLayout/defaultCategory/disabledFields/items/enableAutoValidationThreshold` to the response with the `201` status
  - added the optional property `fieldsLayout/defaultCategory/enabledFields/items/enableAutoValidationThreshold` to the response with the `201` status
  - the `autoValidateIfValidationRulesPass` response's property default value `false` was added for the status `201`
- **2024-06-12** `9b7d1081f5bc`: 8 info
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/hideEnumDetail`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/hideEnumDetail`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/hideEnumDetail`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/hideEnumDetail`
  - added the optional property `fieldsLayout/categories/items/disabledFields/items/hideEnumDetail` to the response with the `201` status
  - added the optional property `fieldsLayout/categories/items/enabledFields/items/hideEnumDetail` to the response with the `201` status
  - added the optional property `fieldsLayout/defaultCategory/disabledFields/items/hideEnumDetail` to the response with the `201` status
  - added the optional property `fieldsLayout/defaultCategory/enabledFields/items/hideEnumDetail` to the response with the `201` status
- **2024-03-04** `c3123d7b7301`: 11 breaking, 4 warning, 84 info
  - added the new required request property `fields/items/fields/items/fieldType`
  - added the new required request property `fieldsLayout/categories/items/disabledFields/items/fieldType`
  - added the new required request property `fieldsLayout/categories/items/enabledFields/items/fieldType`
  - added the new required request property `fieldsLayout/defaultCategory/disabledFields/items/fieldType`
  - added the new required request property `fieldsLayout/defaultCategory/enabledFields/items/fieldType`
  - response property `extractor/organization/validationToolConfig/theme/typography/fontSize` list-of-types was widened by adding types `number` to media type `application/json` of response `201`
  - response property `workspace/organization/validationToolConfig/theme/typography/fontSize` list-of-types was widened by adding types `number` to media type `application/json` of response `201`
  - added `subschema #1, subschema #2` to the `extractor/organization/validationToolConfig/theme/palette/background` response property `oneOf` list for the response status `201`
  - added `subschema #1, subschema #2` to the `workspace/organization/validationToolConfig/theme/palette/background` response property `oneOf` list for the response status `201`
  - the `extractor/organization/validationToolConfig/theme/palette/background` response's property type changed from `object` to no type for status `201`
  - the `workspace/organization/validationToolConfig/theme/palette/background` response's property type changed from `object` to no type for status `201`
  - removed the optional property `extractor/organization/validationToolConfig/theme/palette/background/default` from the response with the `201` status
  - removed the optional property `extractor/organization/validationToolConfig/theme/palette/background/paper` from the response with the `201` status
  - removed the optional property `workspace/organization/validationToolConfig/theme/palette/background/default` from the response with the `201` status
  - removed the optional property `workspace/organization/validationToolConfig/theme/palette/background/paper` from the response with the `201` status
  - added the new optional request property `disableConfirmationIfValidationRulesFail`
  - added the new optional request property `fields/items/fields/items/dataSource`
  - added the new optional request property `fields/items/fields/items/displayEnumValue`
  - added the new optional request property `fields/items/fields/items/displayRawText`
  - added the new optional request property `fields/items/fields/items/dropNull`
  - added the new optional request property `fields/items/fields/items/mapping`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/dataSource`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/displayEnumValue`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/displayRawText`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/dropNull`
  - added the new optional request property `fieldsLayout/categories/items/disabledFields/items/mapping`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/dataSource`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/displayEnumValue`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/displayRawText`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/dropNull`
  - added the new optional request property `fieldsLayout/categories/items/enabledFields/items/mapping`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/dataSource`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/displayEnumValue`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/displayRawText`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/dropNull`
  - added the new optional request property `fieldsLayout/defaultCategory/disabledFields/items/mapping`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/dataSource`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/displayEnumValue`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/displayRawText`
  - added the new optional request property `fieldsLayout/defaultCategory/enabledFields/items/dropNull`
  - …59 more

---

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