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

# Delete Subscription

> Permanently delete a webhook subscription.

Deletes the subscription and stops all deliveries to its endpoint. To pause deliveries temporarily instead, [update](/api-reference/webhooks/update-subscription) it with `active: false`.

### Path Parameters

<ParamField path="subscription_id" type="string" required>
  The subscription to delete.
</ParamField>

### Response

Returns `204 No Content` on success.

<ResponseExample>
  ```json 404 theme={null}
  {
    "detail": "Subscription not found"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl --request DELETE \
    --url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions/7c1d2e3f-... \
    --header 'api-key: YOUR_API_KEY' \
    --header 'secret-key: YOUR_SECRET_KEY'
  ```

  ```python Python theme={null}
  from hostpay import HostPay

  client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")

  client.webhooks.subscriptions.delete("7c1d2e3f-...")
  ```

  ```typescript TypeScript theme={null}
  import { HostPay } from "@hostpay/sdk";

  const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });

  await client.webhooks.subscriptions.delete("7c1d2e3f-...");
  ```
</RequestExample>