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 ofPOST /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
- Add
displayName
on OpenAPI#/components/schemas/AttributeInfo
for resolved views that use that model. - Add
displayName
andsystemName
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 . |