> ## Documentation Index
> Fetch the complete documentation index at: https://guides.affiliate.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Permanently delete a product list by ID. The list and all its stored product IDs are removed immediately and cannot be recovered afterwards.

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.

<Warning>
  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](/api-reference/lists/create-list).
</Warning>

## Request

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

### Headers

<ParamField header="Authorization" type="string" required>
  Your API key as a Bearer token: `Bearer {your_api_key}`.
</ParamField>

### Path parameters

<ParamField path="list_id" type="string" required>
  The unique identifier of the list to delete.
</ParamField>

## Example request

```bash cURL theme={null}
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.

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

### Response fields

<ResponseField name="id" type="string">
  The ID of the list that was deleted.
</ResponseField>

<ResponseField name="status" type="string">
  Confirmation of the deletion. Always `"deleted"` on a successful request.
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="meta properties">
    <ResponseField name="meta.trace_id" type="string">
      Unique request identifier. Include this when contacting support.
    </ResponseField>
  </Expandable>
</ResponseField>