Create Collection
POST/api/collections/createcollection
Tier: Internal — subject to change without notice.
Creates a new Collection from a template, applying the supplied extended-property values.
An unknown {collectionDto}.TemplateId currently returns an unhandled server error (500) rather than the 400 above — verified live 2026-07-03 — because the template's extended-property list is dereferenced before the template-type validator runs. See the known-issues register.
Request
Responses
- 200
- 400
Returns the created Collections.CollectionDetailDto.
Validation failure — empty Name (MissingRequiredField); a duplicate Name among the organisation's active collections (InvalidOperation "Name"); an unknown TemplateId or a TemplateId that does not identify a Collection-type template (InvalidOperation "Invalid Template type" / MissingRequiredField "TemplateId" / InvalidOperation "Incorrect template type"); a template-defined extended property missing from the payload (IncorrectExtendedProperties); an extended-property value that fails its data-type or required-ness check (InvalidExtPropDataType with the property name); a collection-typed extended property referencing the collection itself (DuplicateResource "Collection cannot reference self"); or an item already referenced by another active collection of the same template (InvalidOperation "Extended Property already in use").