# Delete Lead

> Hard delete (consent evidence kept per 02 §15; audited).

Source: https://shopassist.coec.dk/docs/api/reference/engagement/delete-lead · Updated 2026-11-03

`DELETE /v1/stores/{store_id}/leads/{lead_id}`

- Scope: `leads:write`
- Rate limit: 600 requests/min per API key (test keys: 60/min)

Hard delete (consent evidence kept per 02 §15; audited).

## Parameters [#parameters]

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `store_id` | path | `string` | yes |  |
| `lead_id` | path | `string` | yes |  |

## Example request [#example-request]

```bash
curl -X DELETE "https://api.shopassist.coec.dk/v1/stores/sto_01j8000000e008000000000000/leads/lead_01j8000000e008000000000000" \
  -H "Authorization: Bearer $SHOPASSIST_API_KEY"
```

## Response 204 [#response]

Successful Response

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| 400 | Bad Request ([error codes](/docs/api/errors)) |
| 401 | Unauthorized ([error codes](/docs/api/errors)) |
| 403 | Forbidden ([error codes](/docs/api/errors)) |
| 404 | Not Found ([error codes](/docs/api/errors)) |
| 422 | Unprocessable Content ([error codes](/docs/api/errors)) |
| 429 | Too Many Requests ([error codes](/docs/api/errors)) |
