---
title: "Delete webhook subscription"
method: DELETE
path: "/v2/webhook-subscriptions/{subscriptionId}"
tags: ["Webhook Event Subscriptions"]
---

# Delete webhook subscription

`DELETE /v2/webhook-subscriptions/{subscriptionId}`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v2/webhook-subscriptions/{subscriptionId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v2/webhook-subscriptions/:subscriptionId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes a public webhook subscription. This returns `409` if the subscription has group overrides; those overrides must be removed first.

Access to webhook management is gated by brokerage. Talk to Augment to enable access before relying on this endpoint.

## Response `204`

Webhook subscription deleted successfully

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `403`: Webhook management access is not enabled for this brokerage
- `404`: Webhook subscription not found
- `409`: Webhook subscription has group overrides

---

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