Delete webhook

Removes and uninstalls the authenticated user account's active webhook subscription, stopping any further account-level webhook event deliveries. 

DELETE /api/v2/webhook

Table of contents

Endpoint summary

Property Value
HTTP method DELETE
Endpoint path /api/v2/webhook
Authentication Authorization: Bearer <api_key> or Authorization: Basic <base64(username:password)>
Success status code 204 No Content

Note: Deleting the account-level webhook subscription stops automatic event dispatches to the registered webhook URL. If no webhook is currently configured for the account, the endpoint returns 404 Not Found.

Request

Request headers

Header Required Description
Authorization Yes Credentials identifying the user account context (Bearer <api_key> or Basic <credentials>).

Response

204 No Content

The webhook subscription was successfully removed. No response body is returned.

Error responses

When authentication fails or no webhook subscription is currently configured for the user account, the API returns a structured ApiErrorResponse object.

Common error status codes:

Status code Condition Description
401 Unauthorized Missing or invalid credentials Authentication credentials were not provided or could not be resolved to an active user.
404 Not Found No webhook configured No active webhook subscription exists for the authenticated user account.

Error schema (ApiErrorResponse):

Field Type Description
error.code integer HTTP status code (e.g., 401, 404).
error.description string Explanation of the specific error condition.
error.action string Recommended action to resolve the error.
error.timestamp string (ISO 8601) Timestamp when the error occurred.

Examples

1. Delete the active webhook subscription

Uninstalls the currently configured webhook subscription for the authenticated user account.

Request: 

DELETE /api/v2/webhook HTTP/1.1
Host: localhost:9509
Authorization: Bearer <api_key>

Response (204 No Content): 

HTTP/1.1 204 No Content

(Empty response body)

2. Error: No webhook configured (404 Not Found)

Returned when attempting to delete a webhook when no active subscription exists.

Response (404 Not Found): 

{
  "error": {
    "code": 404,
    "description": "No webhook is currently configured for this account.",
    "action": "Register a webhook using POST /api/v2/webhook or PUT /api/v2/webhook.",
    "timestamp": "2026-10-21T10:21:00+02:00"
  }
}

More information