---
title: "Delete webhook subscription"
method: DELETE
path: "/v1/workspaces/{workspace_id}/webhooks/{subscription_id}"
tags: ["Webhooks"]
---

# Delete webhook subscription

`DELETE /v1/workspaces/{workspace_id}/webhooks/{subscription_id}`

## Request

- Base URL: `https://api.blinq.me`
- URL: `https://api.blinq.me/v1/workspaces/{workspace_id}/webhooks/{subscription_id}`
- Auth: HTTP bearer

Available to any API-eligible account with a verified email address.

Soft-deletes a webhook subscription in your personal workspace or a business workspace where you are an owner or admin. The subscription stops matching new events immediately, and pending deliveries are cancelled before their next attempt.

Missing subscriptions, already-deleted subscriptions, subscriptions in another workspace, and inaccessible workspaces all return `404` without revealing whether the subscription exists.

Requires the `blinq:webhooks:write` scope.

## Path parameters

- `workspace_id` string, required
- `subscription_id` string, required

## Response `204`

No content - The subscription was deleted

## Other responses

- `400`: Bad request - Invalid query parameters or body. See `details` for each failing field
- `401`: Unauthorized - Missing or invalid API key
- `403`: Forbidden - Missing scope, insufficient permission, or the plan does not include this operation
- `404`: Not found - The subscription or workspace was not found or access was denied

---

[API](https://skmtc.dev/blinq/apis/blinq-public-api.md) - [All operations](https://skmtc.dev/blinq/apis/blinq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blinq/apis/blinq-public-api/revisions/2dedf4b14340?raw)