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

# Delete Collection

> Delete a collection

# Delete Collection

Permanently deletes a collection. This action cannot be undone. Products in the collection are not deleted, only their association with the collection is removed.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.launchmystore.io/api/v1/collections/col_abc123.json" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.launchmystore.io/api/v1/collections/col_abc123.json', {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
    }
  });
  ```
</CodeGroup>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique collection ID to delete
</ParamField>

## Response

Returns the standard response envelope confirming deletion.

<ResponseField name="status" type="integer">
  HTTP status code
</ResponseField>

<ResponseField name="state" type="string">
  Result state, e.g. `success`
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable confirmation message
</ResponseField>

<ResponseField name="data" type="object">
  Not populated for this endpoint
</ResponseField>

## Example Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "message": "Collection deleted successfully",
  "data": null
}
```

## Notes

* Deleting a collection does not delete the products in it
* Products are simply disassociated from the collection
* Navigation menu links pointing to this collection will become broken

## Errors

On failure the same envelope is returned with `state: "error"` and a `message`:

```json theme={null}
{
  "status": 404,
  "state": "error",
  "message": "Collection not found",
  "data": null
}
```

| Status | Condition                                       |
| ------ | ----------------------------------------------- |
| `401`  | Invalid or missing access token                 |
| `403`  | App doesn't have `write_products` scope         |
| `404`  | Collection with the specified ID does not exist |