delete combinations.

Deletes combinations for the product identified by key. Three independent deletion modes can be combined in one request (OR semantics — all provided modes are applied):

attributes: list of attribute IDs — every combination of the product that contains any of these attributes is deleted; the attribute itself is also detached from the product.

options: list of option IDs — every combination that contains any of these options is deleted; the parent attribute is detached from the product if no sibling option remains.

product_variants: detailed mode — delete specific variants by their attributes/quantities combination. Each product_variants[].attributes[] entry MUST provide at least one of attribute_id/attribute_key and at least one of option_id/option_key (enforced server-side, throws 400 otherwise).

URL note: this endpoint uses singular /api/product/combinations while POST uses plural /api/products/combinations — this URL inconsistency is preserved for backwards compatibility.

IMPORTANT: the request is processed asynchronously. HTTP 200 only confirms acceptance — actual deletion is handled by a worker that runs every 10 minutes (at minute :00, :10, :20, … UTC), scaling with the number of combinations to remove.

Request

Header Params

Body Params application/json

Example

{
    "key": "ext-product-1",
    "attributes": [
        "a1111111-1111-1111-1111-111111111111"
    ],
    "options": [
        "o1111111-1111-1111-1111-111111111111"
    ],
    "product_variants": [
        {
            "attributes": [
                {
                    "attribute_id": "a2222222-2222-2222-2222-222222222222",
                    "option_id": "o2222222-2222-2222-2222-222222222222"
                }
            ],
            "quantities": [
                {
                    "quantity_id": "q1111111-1111-1111-1111-111111111111",
                    "delivery": {
                        "de": {
                            "s1111111-1111-1111-1111-111111111111": {}
                        }
                    }
                }
            ]
        }
    ]
}

Request

Responses