> 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/wishlists/deletewishlist.md).

# deleteWishlist

Delete Wishlist marks the wishlist as deleted and produces an HTTP response confirming the action. The Wishlist is identified either by the TWC Internal wishlist identifier ***wishlistId*** or the retailers own ***wishlistRef***. The wishlists are actually retained in the system for reporting purposes, but are de-identified so cannot be linked back to the customer.

If the wishlist 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":"wishlists","description":"Create, read, update and delete wishlists, and look them up by id, reference or customer."}],"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":{"wishlistRef":{"name":"wishlistRef","in":"query","required":false,"description":"The retailer's unique identifier for a wishlist.  Implementations typically use the TWC unique identifier rather than this parameter.","schema":{"type":"string"}},"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/wishlists":{"delete":{"summary":"deleteWishlist","operationId":"deleteWishListUsingDELETE","parameters":[{"$ref":"#/components/parameters/wishlistRef"},{"$ref":"#/components/parameters/X-TWC-Tenant-2"},{"in":"query","name":"id","description":"The unique wishlist identifier","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"}},"deprecated":false,"description":"Delete Wishlist marks the wishlist as deleted and produces an HTTP response confirming the action. The Wishlist is identified either by the TWC Internal wishlist identifier ***wishlistId*** or the retailers own ***wishlistRef***. The wishlists are actually retained in the system for reporting purposes, but are de-identified so cannot be linked back to the customer.\n\nIf the wishlist does not exist, this method returns a ResourceNotFound error.","tags":["wishlists"]}}}}
```