---
title: "Delete a Webhook Subscription"
method: DELETE
path: "/v1/webhooks/subscriptions/{subscription_id}"
tags: ["Webhooks"]
---

# Delete a Webhook Subscription

`DELETE /v1/webhooks/subscriptions/{subscription_id}`

## Request

- Base URL: `https://api.monaco.com`
- URL: `https://api.monaco.com/v1/webhooks/subscriptions/{subscription_id}`
- Auth: none declared

Stops delivery permanently. The signing secret cannot be recovered afterwards, and the delivery history stays readable.

**Error codes**

| `error.code` | HTTP | Cause | What to do |
| --- | --- | --- | --- |
| `not_found` | 422 | No subscription with this id exists in the calling org. | Check the id; a deleted subscription is never returned. |

## Path parameters

- `subscription_id` string, uuid, required

## Response `204`

Successful Response

## Other responses

- `4XX`: Client error

## Changes

- **2026-11-03** `fc720ada2a81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monaco/apis/monaco-public-api/changes/v1/webhooks/subscriptions/:subscription_id/delete.md)

---

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