---
title: "Delete Webhook"
method: DELETE
path: "/api/v1/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Delete Webhook

`DELETE /api/v1/webhooks/{webhook_id}`

Delete a specific webhook endpoint by its unique identifier.

**Request Parameters:**
- `webhook_id`: Unique identifier of the webhook to delete (path parameter)

**Response Behavior:**
- Successfully deletes the webhook and returns a confirmation message
- Returns 404 if webhook doesn't exist or user doesn't have access
- Returns 500 for internal server errors

**Security:**
- Only the webhook owner can delete their webhook
- Webhook ID must be a valid MongoDB ObjectId format
- Requires valid authentication token

**Use Cases:**
- Remove unused webhook endpoints
- Clean up webhook configurations
- Disable event notifications for specific URLs
- Maintain webhook hygiene and security

**Important Notes:**
- This action is irreversible - deleted webhooks cannot be recovered
- All webhook event subscriptions are immediately terminated
- No events will be sent to the deleted webhook URL
- Consider temporarily disabling webhooks instead of deletion for testing

**Error Handling:**
- 404: Webhook not found or access denied
- 500: Internal server error with detailed error information

## Path parameters

- `webhook_id` string, required

## Response `200`

Webhook deleted successfully

- WebhookDeleteSuccessResponse — Webhook delete success response (HTTP 200)
  - `success` boolean — Operation success status - always true for successful responses
  - `message` string, required — Success message confirming webhook deletion

## Other responses

- `404` — Webhook not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/neosapien/apis/neocore.md) · [All operations](https://skmtc.dev/neosapien/apis/neocore/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neosapien/neocore/revisions/8b94ef58f2cf/schema)