Skip to main content

Upsert Category

POST 
/api/Categories/BulkUpsert

Tier: Public — stable, supported for third-party integration.

Bulk-creates/updates Categories, matched by (OrganisationId, ExternalRef). Parent categories (via BulkUpsertDimItemDto.ParentExternalRef) must already exist in the database — an in-batch parent that only appears earlier in the same request is not resolved.

Request​

Responses​

Always returned. Body is an array of BulkUpsert.BulkUpsertResultDto, one per input row in the same order, each carrying its own Status.