Skip to content

PIM 25.0

Version 25.0
Release Date 25 March 2025

Changes

Enhancements

  • Add endpoint POST /api/products/family/search, used find all product families for given products. See deprecation of POST /api/resolved-views/products/families/-search below.
  • Add structural version to resolved views:
    • Add structuralVersion property on /#components/schemas/AttributePredefinedValuesView.
    • Add structuralVersion property on /#components/schemas/BrandView.
    • Add structuralVersion property on /#components/schemas/AttributeView.
    • Add structuralVersion property on /#components/schemas/GlobalListView.
    • Add structuralVersion property on /#components/schemas/ProductHierarchyView.
    • Add structuralVersion property on /#components/schemas/PublishedProductView.
  • Add displayName on OpenAPI #/components/schemas/AttributeInfo for resolved views that use that model.
  • Add displayName and systemName on OpenAPI #/components/schemas/AttributeField for resolved views that use that model.

Breaking changes (v24)

AttributeGroups

Endpoint Comment
GET /api/attribute-groups Limit page size to 100 items, default to 10.
GET /api/attribute-groups/{attributeGroupId}/items Limit page size to 100 items, default to 10.
PUT /api/attribute-groups/{attributeGroupId}/items Limit payload size to 100 items.

AttributeOrders

Endpoint Comment
GET /api/attribute-orders Limit page size to 100 items, default to 10.
PUT /api/attribute-orders/items Limit payload size to 100 items.

Attributes

Endpoint Comment
GET /api/attributes Limit page size to 100 items, default to 10.
POST /api/attributes/-search-by-ids Route changed to /api/attributes/search-by-ids Limit page size to 100 items, default to 10.
POST /api/attributes/-search-by-system-names Route changed to /api/attributes/search-by-system-names Limit page size to 100 items, default to 10.
POST /api/attributes/import/csv Models containing the term task have been renamed to the term job for consistency.
POST /api/attributes/predefined-values/import/csv Models containing the term task have been renamed to the term job for consistency.

Brands

Endpoint Comment
GET /api/brands Limit page size to 100 items, default to 10.
POST /api/brands/import/csv Models containing the term task have been renamed to the term job for consistency.

Channels

Endpoint Comment
GET /api/channels Limit page size to 100 items, default to 10.

Devices

Endpoint Comment
GET /api/devices Limit page size to 100 items, default to 10.

Domain Events / Webhooks

Endpoint Comment
GET /api/domain-events Route changed to /api/webhooks Limit page size to 100 items, default to 10.
GET /api/domain-events/{domainEventTypeToGet} Route changed to /api/webhooks/{webhookTypeToGet}/subscribers Limit page size to 100 items, default to 10.
PUT /api/domain-events/{domainEventTypeToUpdate} Route changed to POST /api/webhooks/{webhookTypeToUpdate}/subscribers.

External Bulk Operations

Endpoint Comment
GET /api/external-bulk-operations Limit page size to 100 items, default to 10.

Global Lists

Endpoint Comment
GET /api/global-lists Deprecated.
GET /api/global-lists/-without-items Route changed to GET /api/global-lists Limit page size to 100 items, default to 10 (notice this replaces preceding endpoint).
GET /api/global-lists/{globalListId}/items Limit page size to 100 items, default to 10.
POST /api/global-lists/import/csv Models containing the term task have been renamed to the term job for consistency.

Markets

Endpoint Comment
GET /api/markets Limit page size to 100 items, default to 10.

Products

Endpoint Comment
PATCH /api/products Limit payload size to 100 items.
POST /api/products/-filter Route changed to POST /api/products/filter Limit page size to 100 items, default to 10.
POST /api/products/-search-by-ids Route changed to POST /api/products/search-by-ids Limit page size to 100 items, default to 10.
POST /api/products/-search-by-ids/attribute-collection Route changed to POST /api/products/search-by-ids/attribute-collection Limit page size to 100 items, default to 10.
POST /api/products/bundles/import/csv Models containing the term task have been renamed to the term job for consistency.
POST /api/products/enqueue-bulk-deletion Models containing the term task have been renamed to the term job for consistency. Limit payload size to 1000 items.
POST /api/products/enqueue-bulk-deletion-by-systemname Models containing the term task have been renamed to the term job for consistency. Limit payload size to 1000 items.
POST /api/products/enqueue-bulk-unpublish Models containing the term task have been renamed to the term job for consistency. Limit payload size to 1000 items.
POST /api/products/export/csv Models containing the term task have been renamed to the term job for consistency.
POST /api/products/import/csv Models containing the term task have been renamed to the term job for consistency.
POST /api/products/import/json Models containing the term task have been renamed to the term job for consistency.
POST /api/products/import/json/new-products Models containing the term task have been renamed to the term job for consistency.

Referential values

Endpoint Comment
POST /api/referential-values/-resolve Route changed to POST /api/referential-values/resolve Limit payload size 100 items (summed size of all arrays).

Resolved Views

Endpoint Comment
POST /api/resolved-views/attribute-field-values/-resolve Route changed to POST /api/resolved-views/attribute-field-values/resolve.
POST /api/resolved-views/attribute-predefined-values/-search Route changed to POST /api/resolved-views/attribute-predefined-values/search, and properties attributeGroupIds andattributeGroups are deprecated.
POST /api/resolved-views/brands/-search Route changed to POST /api/resolved-views/brands/search, and properties attributeGroupIds andattributeGroups are deprecated.
POST /api/resolved-views/global-lists/-search Route changed to POST /api/resolved-views/global-lists/search, and properties attributeGroupIds andattributeGroups are deprecated.
POST /api/resolved-views/products/-search Route changed to POST /api/resolved-views/products/search, and properties attributeGroupIds andattributeGroups are deprecated.
POST /api/resolved-views/products/families/-search Endpoint is deprecated and replaced by POST /api/products/family/search in combination with POST /api/resolved-views/products/search.
POST /api/resolved-views/product-hierarchies/-search Route changed to POST /api/resolved-views/product-hierarchies/search, and properties attributeGroupIds andattributeGroups are deprecated.

Segmentations

Endpoint Comment
GET /api/segmentations Limit page size to 100 items.

Tasks / Jobs

Endpoint Comment
GET /api/tasks/{taskId}/input-file Route changed to GET /api/jobs/{jobId}/input-file.
GET /api/tasks/{taskId}/result Route changed to GET /api/jobs/{jobId}/result.
GET /api/tasks/{taskId}/status Route changed to GET /api/jobs/{jobId}/status.
GET /api/tasks/list-task-names Route changed to GET /api/jobs/list-job-names.

Test

Endpoint Comment
GET /api/test Deprecated.

TranslationCultures

Endpoint Comment
GET /api/translation-cultures Limit page size to 100 items.

Users

Endpoint Comment
POST /api/users/-search-by-ids Route changed to POST /api/users/search-by-ids.