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

# Delete Promotion

> Delete a promotion and its associated codes

<ParamField header="Authorization" type="string" required>
  Bearer token with `marketing:write` scope
</ParamField>

<ParamField path="id" type="string" required>
  The promotion ID
</ParamField>

## Behavior

* Deletes the promotion and all associated promotion codes
* Cannot delete promotions that have redemption records
* For promotions with redemptions, archive them instead by setting `status: "archived"`

## Response

```bash Request theme={null}
curl -X DELETE "https://api.voyantcloud.com/v1/promotions/promo_abc123" \
  -H "Authorization: Bearer $API_KEY"
```

```json Response theme={null}
{
  "success": true
}
```

## Errors

| Status | Error                                    | Description                                  |
| ------ | ---------------------------------------- | -------------------------------------------- |
| 400    | Cannot delete promotion with redemptions | Promotion has been used. Archive it instead. |
| 404    | Promotion not found                      | No promotion exists with the given ID        |