> For the complete documentation index, see [llms.txt](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://the-wishlist-documentation.gitbook.io/the-wishlist-documentation-docs/wishlist-rest-api/wishlist-items/deletewishlistitembyref.md).

# deleteWishListItemByRef

Delete Wishlist Item by itemRef marks the item matching the given ***wishlistItemRef*** (retailer’s own identifier) as deleted and produces an HTTP response confirming the action.

Note that itemRef is the client’s unique identifier for a wishlist item associated with a single wishlist. It is NOT the productRef, which typically could be the retailer’s product SKU.

This endpoint is not typically used by our customers, as few retailers will have their own identifier at the wishlist item level. Typically the deleteWishlistItemByID is used instead.

If the retailer is automatically deleting items from a customer's wishlist when they are purchased, we recommend setting the purchasedAndRemoved flag.

If the wishlist/item does not exist, this method returns a ResourceNotFound error.

```json
{"openapi":"3.0.3","info":{"title":"Wishlist REST API","version":"0.0.1"},"tags":[{"name":"wishlist-items","description":"Add, update, remove and query the items on a wishlist."}],"servers":[{"url":"https://api.au-aws.thewishlist.io/services/wsservice"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","description":"OAuth2 bearer token issued by TWC Keycloak, sent as `Bearer <token>`."}},"parameters":{"X-TWC-Tenant-2":{"name":"X-TWC-Tenant","in":"header","required":false,"description":"tenant-key (your retail store's unique identifier in TWC)","schema":{"type":"string"}}}},"paths":{"/api/wishlist/items/{wishlistItemRef}/ref":{"delete":{"summary":"deleteWishListItemByRef","operationId":"deleteWishListItemByRefUsingDELETE","parameters":[{"name":"purchasedAndRemoved","in":"query","description":"purchasedAndRemoved","required":false,"schema":{"type":"boolean"}},{"name":"wishlistItemRef","in":"path","description":"wishlistItemRef","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/X-TWC-Tenant-2"}],"responses":{"200":{"description":"OK"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"deprecated":false,"description":"Delete Wishlist Item by itemRef marks the item matching the given ***wishlistItemRef*** (retailer’s own identifier) as deleted and produces an HTTP response confirming the action.\n\nNote that itemRef is the client’s unique identifier for a wishlist item associated with a single wishlist. It is NOT the productRef, which typically could be the retailer’s product SKU.\n\nThis endpoint is not typically used by our customers, as few retailers will have their own identifier at the wishlist item level.  Typically the deleteWishlistItemByID is used instead.\n\nIf the retailer is automatically deleting items from a customer's wishlist when they are purchased, we recommend setting the purchasedAndRemoved flag.\n\nIf the wishlist/item does not exist, this method returns a ResourceNotFound error.","tags":["wishlist-items"]}}}}
```