Skip to main content
Server path: /commercetools-products | Type: Application | PCID required: Yes

Tools


commercetools_products_create_attribute_groups

POST /attribute-groups Parameters:
For implementing funnel search on Product Listing Pages where users select multiple filters, use this POST method. To avoid URL length restrictions, this method passes the same query parameters as defined in the GET method, within the request body in URL-encoded format. Parameters:

commercetools_products_create_product_tailoring

Generates the ProductTailoringCreated Message. Parameters:

commercetools_products_create_product_types

POST /product-types Parameters:

commercetools_products_create_products

To create a new Product, send a representation that is going to become the initial staged and current representation of the new Product in the catalog. If Product price selection query parameters are provided, selected Prices will be added to the response. Produces the ProductCreated Message. Parameters:

commercetools_products_create_products_images_by_id

Uploads a JPEG, PNG, or a GIF image file to a ProductVariant. The maximum file size of the image is 10MB. Either variant or sku is required to update a specific ProductVariant. If neither is provided, the image is uploaded to the Master Variant of the Product. The response status code depends on the size of the original image. If the image is small, the API responds with 200 OK, and if the image is larger, it responds with 202 Accepted. The Product returned with a 202 Accepted status code contains a warnings field with an ImageProcessingOngoing Warning. Produces the ProductImageAdded Message. Parameters:
If indexing is in progress or if Product Search is inactive, an ObjectNotFound error is returned. If inactive, you can reactivate it. Parameters:

commercetools_products_delete_attribute_groups_by_id

DELETE /attribute-groups/{ID} Parameters:

commercetools_products_delete_attribute_groups_by_key

DELETE /attribute-groups/key={key} Parameters:

commercetools_products_delete_by_id

If Product price selection query parameters are provided, the selected Prices are added to the response. Produces the ProductDeleted Message. Parameters:

commercetools_products_delete_by_key

If Product price selection query parameters are provided, the selected Prices are added to the response. Produces the ProductDeleted Message. Parameters:

commercetools_products_delete_product_tailoring_by_id

Generates the ProductTailoringDeleted Message. Parameters:

commercetools_products_delete_product_tailoring_by_key

Generates the ProductTailoringDeleted Message. Parameters:

commercetools_products_delete_product_types_by_id

DELETE /product-types/{ID} Parameters:

commercetools_products_delete_product_types_by_key

DELETE /product-types/key={key} Parameters:

commercetools_products_get_attribute_groups_by_id

GET /attribute-groups/{ID} Parameters:

commercetools_products_get_attribute_groups_by_key

GET /attribute-groups/key={key} Parameters:

commercetools_products_get_by_id

If Product price selection query parameters are provided, the selected Prices are added to the response. Parameters:

commercetools_products_get_by_key

If Product price selection query parameters are provided, the selected Prices are added to the response. Parameters:

commercetools_products_get_product_projections_by_id

Retrieves the projected representation of a Product by its ID. By default, this endpoint returns the current representation of Products where the published flag is true. If a Product is unpublished (published=false), the endpoint returns a Not Found error. Required access scopes: - To retrieve the current representation of published Products (published data), the view_published_products:{projectKey} scope is required. - To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the view_products:{projectKey} scope. Parameters:

commercetools_products_get_product_projections_by_key

Retrieves the projected representation of a Product by its Key. By default, this endpoint returns the current representation of Products where the published flag is true. If a Product is unpublished (published=false), the endpoint returns a Not Found error. Required access scopes: - To retrieve the current representation of published Products (published data), the view_published_products:{projectKey} scope is required. - To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the view_products:{projectKey} scope. Parameters:

commercetools_products_get_product_tailoring_by_id

GET /product-tailoring/{ID} Parameters:

commercetools_products_get_product_tailoring_by_key

GET /product-tailoring/key={key} Parameters:

commercetools_products_get_product_types_by_id

GET /product-types/{ID} Parameters:

commercetools_products_get_product_types_by_key

GET /product-types/key={key} Parameters:

commercetools_products_list_attribute_groups

GET /attribute-groups Parameters:

commercetools_products_list_product_projections

Retrieves the projected representation of Products by query predicates. By default, this endpoint returns the current representation of Products where the published flag is true. If a Product is unpublished (published=false), the endpoint returns a Not Found error. Required access scopes: - To retrieve the current representation of published Products (published data), the view_published_products:{projectKey} scope is required. - To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the view_products:{projectKey} scope. Parameters:
This method appends query parameters to the URL. The maximum allowed URL length is 8192 characters. Exceeding this limit will result in URL truncation, potentially leading to unexpected results. For funnel searches on Product Listing Pages, where users select multiple filters, we recommend the POST method which passes the query parameters within the request body, avoiding URL length restrictions. Parameters:

commercetools_products_list_product_projections_suggest

GET /product-projections/suggest Parameters:

commercetools_products_list_product_tailoring

GET /product-tailoring Parameters:

commercetools_products_list_product_types

GET /product-types Parameters:

commercetools_products_list_products

If Product price selection query parameters are provided, the selected Prices are added to the response. Parameters:

commercetools_products_list_products_product_selections_by_id

GET /products/{ID}/product-selections Parameters:

commercetools_products_list_products_product_selections_by_key

GET /products/key={key}/product-selections Parameters:

commercetools_products_update_attribute_groups_by_id

POST /attribute-groups/{ID} Parameters:

commercetools_products_update_attribute_groups_by_key

POST /attribute-groups/key={key} Parameters:

commercetools_products_update_product_tailoring_by_id

POST /product-tailoring/{ID} Parameters:

commercetools_products_update_product_tailoring_by_key

POST /product-tailoring/key={key} Parameters:

commercetools_products_update_product_types_by_id

POST /product-types/{ID} Parameters:

commercetools_products_update_product_types_by_key

POST /product-types/key={key} Parameters:

commercetools_products_update_products_by_id

If Product price selection query parameters are provided, the selected Prices are added to the response. A failed response can return a DuplicatePriceScope, DuplicateVariantValues, DuplicateAttributeValue, or DuplicateAttributeValues error. Parameters:

commercetools_products_update_products_by_key

A failed response can return a DuplicatePriceScope, DuplicateVariantValues, DuplicateAttributeValue, or DuplicateAttributeValues error. Parameters: