# Delete a subscription

> Revokes (soft-deletes) the subscription; deliveries stop immediately. Not gated on plan tier, a downgraded workspace can still turn off deliveries it can no…

Source: https://warmerly.com/docs/webhooks/delete-a-subscription

```text
DELETE /webhooks/subscriptions/{id}
```

Revokes (soft-deletes) the subscription; deliveries stop immediately. Not gated on plan tier, a downgraded workspace can still turn off deliveries it can no longer manage.

```bash
curl -X DELETE https://app.warmerly.com/api/v1/webhooks/subscriptions/e5b3a7c2-8d4e-4f0a-9c2b-6a1d3e8f5c7b \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json
{ "revoked": true }
```

`404 not_found` if the subscription doesn't exist, isn't yours, or was already revoked.

## More from Webhooks

- [Update a subscription](https://warmerly.com/docs/webhooks/update-a-subscription): Currently the only supported update is toggling active, there's no way to change targetUrl or eventTypes in…
- [Delivery & retries](https://warmerly.com/docs/webhooks/delivery-and-retries): Deliveries are dispatched by a background sweep (not real-time) that polls for new events every 5 minutes.…
- [Known gaps in this page](https://warmerly.com/docs/webhooks/known-gaps-in-this-page): Known gaps in this page in the Warmerly Webhooks API reference.
