DELETE /v1/products/lists/{id} — delete a list

Use DELETE /v1/products/lists/{list_id} to permanently delete a product list. The response confirms deletion with the list ID and a "deleted" status.

Deleting a list is permanent and cannot be undone. The list and all its stored product IDs are removed immediately. If you need the list later, recreate it using POST /v1/products/lists.

Request

Endpoint: DELETE /v1/products/lists/{list_id}

Headers

string

required

Your API key as a Bearer token: Bearer {your_api_key}.

Path parameters

string

required

The unique identifier of the list to delete.

Example request

cURL

curl --request DELETE \
  --url 'https://api.affiliate.com/v1/products/lists/{list_id}' \
  --header 'Authorization: Bearer {your_api_key}'

Response

A 200 OK response confirms the list has been deleted.

{
  "id": "d345e67f-89g0-1h2i-3j45-6k7891lm2345",
  "status": "deleted",
  "meta": {
    "trace_id": "c1d2e3f4-5g6h-7i8j-9k10-l1m2n3o4p5q6"
  }
}

Response fields

string

The ID of the list that was deleted.

string

Confirmation of the deletion. Always "deleted" on a successful request.

object

Show meta properties

string

Unique request identifier. Include this when contacting support.

Account

Networks

Merchants

Products

Tools

Watches

Product Lists

Pools

Reports

DELETE /v1/products/lists/{id} — delete a list

Request

Headers

Path parameters

Example request

Response

Response fields

​Request

​Headers

​Path parameters

​Example request

​Response

​Response fields

Request

Headers

Path parameters

Example request

Response

Response fields