--- title: "Remove a item" method: DELETE path: "/v1/wishlists/{wishlistId}/items/{itemKey}" tags: ["wishlists"] --- # Remove a item `DELETE /v1/wishlists/{wishlistId}/items/{itemKey}` This endpoint allows you to remove an item previously added to any given wishlist. __Note__: It will remove single items from the wishlist, not the entire wishlist. ## Path parameters - `wishlistId` string, required - `itemKey` string, required ## Query parameters - `campaignKey` string - `pricePromotionKey` string - `displayHighestPpkPrice` boolean - `forcePPKSaleCategories` boolean - `with` string[] ## Response `200` request successful - Wishlist - `key` string, required - `items` WishlistItem[], required - `key` string, required - `packageId` integer, required - `quantity` integer, required - `status` 'available' | 'unavailable', required - `product` Product - `id` integer, required - `advancedAttributes` object - `attributes` object - `baseCategories` BaseCategory[] - `categoryId` integer, required — Unique identifier of the category - `categoryName` string, required — Name of the category - `categoryParentId` integer, required — Parent ID of the category - `categoryPath` string, required — Category path as text - `categories` array[] - ProductCategory[] - `categoryId` integer - `categoryHidden` boolean - `categoryName` string - `categoryProperties` object - `is_inheritable` integer - `name` string - `value` string - `shopLevelCustomData` object - `appCatName` object - `appCatLocalizedConfig` object - `countryLevelCustomData` object - `appCatCountryName` string - `appCatCountryScore` number - `appCatCountryBubbleUp` boolean - `appCatCountrySampleName` string - `appCatCountrySampleConfig` object - `appCatCountryLocalizedConfig` object - `categoryUrl` string - `categorySlug` string - `definingAttributes` DefiningAttribute - `id` integer, required - `label` string, required - `images` Image[], required - `attributes` object - `hash` string - `customData` ResponseCustomData, required - `isActive` boolean, required — Identifies whether a product is active or not - `isNew` boolean, required — Identifies whether a product is new or not - `isSoldOut` boolean, required — Identifies if a product is still available to sell - `masterKey` string, required — Identifies the master product which this product belongs - `firstLiveAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `priceRange` PriceRange - `max` Price, required - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - … - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - … - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `min` Price, required - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - … - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - … - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `reductionRange` ReductionRange - `max` Price - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - … - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - … - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `min` Price - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - … - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - … - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `lowestPriorPrice` LowestPriorPrice — Information about the lowest price in the past 30 days. - `withTax` integer, nullable, required — The lowest price including tax. - `relativeDifferenceToPrice` number, float, nullable, required — The relative difference from the lowest prior price to the current price. If the value is positive, it means that the current price is higher than the lowest prior price. If the value is negative, it means that the current price is lower than the lowest prior price. - `referenceKey` string, required - `searchCategoryIds` integer[] - `siblings` Product[] — list of Products - `variants` Variant[] - `id` integer, required - `advancedAttributes` object - `appliedPricePromotionKey` string - `attributes` object - `lowestPriorPrice` LowestPriorPrice — Information about the lowest price in the past 30 days. - `withTax` integer, nullable, required — The lowest price including tax. - `relativeDifferenceToPrice` number, float, nullable, required — The relative difference from the lowest prior price to the current price. If the value is positive, it means that the current price is higher than the lowest prior price. If the value is negative, it means that the current price is lower than the lowest prior price. - `price` Price, required - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - … - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - … - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `productId` integer, required - `referenceKey` string, required - `firstLiveAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `stock` Stock, required - `supplierId` integer, required - `warehouseId` integer, nullable, required - `quantity` integer, required - `isSellableWithoutStock` boolean, required - `expectedAvailabilityAt` string, nullable, required - `customData` object, required - `merchant` Merchant - `id` integer, required - `key` string, required - `name` string, required - `legal` object - `legaName` string - `parentCompanyLegalName` string - `streetWithNumber` string - `zip` string - `city` string - `country` string - `telephone` string - `email` string - `registryCourtCity` string - `registerNumber` string - `parentCompanyRegistryCourtCity` string - `parentCompanyRegisterNumber` string - `managingDirectors` string - `representative` string - `shippingMerchantName` string - `registryCourtType` string - `parentCompanyRegistryCourtType` string - `vatId` string - `createdAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `updatedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `createdAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `updatedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `indexedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `variant` Variant - `id` integer, required - `advancedAttributes` object - `appliedPricePromotionKey` string - `attributes` object - `lowestPriorPrice` LowestPriorPrice — Information about the lowest price in the past 30 days. - `withTax` integer, nullable, required — The lowest price including tax. - `relativeDifferenceToPrice` number, float, nullable, required — The relative difference from the lowest prior price to the current price. If the value is positive, it means that the current price is higher than the lowest prior price. If the value is negative, it means that the current price is lower than the lowest prior price. - `price` Price, required - `appliedReductions` AppliedReduction[], required - `amount` AppliedReductionAmount, required - `absoluteWithTax` integer - `relative` number - `category` 'sale' | 'campaign' | 'promotion', required - `type` string, required - `currencyCode` string, required — The currency of the price. - `reference` object - `size` integer — Size of the reference (100m, 100ml), but in this field fill in only the value without the unit of measurement. - `unit` string — The size of reference unit (KG, ml, L, etc.) without the value - `withoutTax` integer — Reference price excluding the taxes. - `withTax` integer — Item price including taxes. The price is calculated including taxes and all applicable reductions such as discounts for sale and campaigns (should a campaign key be provided on the request). - `tax` Tax, required - `vat` Vat - `amount` number - `rate` number - `withoutTax` integer, required - `withTax` integer, required - `recommendedRetailPrice` integer, required - `productId` integer, required - `referenceKey` string, required - `firstLiveAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `stock` Stock, required - `supplierId` integer, required - `warehouseId` integer, nullable, required - `quantity` integer, required - `isSellableWithoutStock` boolean, required - `expectedAvailabilityAt` string, nullable, required - `customData` object, required - `merchant` Merchant - `id` integer, required - `key` string, required - `name` string, required - `legal` object - `legaName` string - `parentCompanyLegalName` string - `streetWithNumber` string - `zip` string - `city` string - `country` string - `telephone` string - `email` string - `registryCourtCity` string - `registerNumber` string - `parentCompanyRegistryCourtCity` string - `parentCompanyRegisterNumber` string - `managingDirectors` string - `representative` string - `shippingMerchantName` string - `registryCourtType` string - `parentCompanyRegistryCourtType` string - `vatId` string - `createdAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `updatedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00 - `productId` integer, required - `masterKey` string - `variantId` integer - `customData` object, required ## Other responses - `401` — Authentication information is missing or invalid - `404` — The specified resource was not found ## Changes - **2026-07-17** `8cfa924ae703` — 12 breaking, 36 warning, 129 info - the response property `items/items/product/attributes/additionalProperties/values` became nullable for the status `200` - the response property `items/items/product/images/items/attributes/additionalProperties/values` became nullable for the status `200` - the response property `items/items/product/lowestPriorPrice/relativeDifferenceToPrice` became nullable for the status `200` - the response property `items/items/product/lowestPriorPrice/withTax` became nullable for the status `200` - …173 more - **2023-08-06** `302b7c443b51` — 148 breaking, 8 warning, 38 info - the response property `items/items/product/attributes/additionalProperties/id` became nullable for the status `200` - the response property `items/items/product/attributes/additionalProperties/type` became nullable for the status `200` - the response property `items/items/product/attributes/additionalProperties/values/items/id` became nullable for the status `200` - the response property `items/items/product/attributes/additionalProperties/values/items/label` became nullable for the status `200` - …190 more [Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/wishlists/:wishlistId/items/:itemKey/delete.md) --- [API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)