Skip to content

Delete Wishlist Item ​

Remove a single item from the authenticated customer's wishlist.

Endpoint ​

DELETE /api/shop/wishlists/{id}

Request Headers ​

HeaderRequiredDescription
Content-TypeYesapplication/json
X-STOREFRONT-KEYYesYour storefront API key
AuthorizationYesCustomer Bearer token (Bearer <accessToken>)

Path Parameters ​

ParameterTypeRequiredDescription
idintegerYesWishlist item ID to delete

Response ​

204 No Content with an empty body. There is no confirmation message — the status is the confirmation.

Behaviour ​

  • Only the row is removed; the product itself is untouched and can be saved again straight away.
  • A row that belongs to another customer answers 404, exactly as an ID that does not exist.
  • Repeating the call on an already-deleted row answers 404.

Use Cases ​

  • Remove one saved product — call with the row's id, then drop it from the rendered list; the empty body leaves nothing to re-render from.
  • Un-save from a product page — when the row ID is not at hand, Toggle removes by product ID instead and needs no lookup.

Best Practices ​

  • Track the row id, not the product ID — this endpoint addresses the wishlist row; only Toggle works from a product ID.
  • Do not parse a body — a 204 carries none, so a client expecting a message object reads undefined.
  • Treat 404 as already gone — after a successful Move to Cart the row no longer exists.

Released under the MIT License.