Delete webhook endpoint
Remove an outbound webhook subscription from a dashboard.
DELETE /app/integrations/webhooks/outbound/endpoints
Permanently removes a webhook endpoint for the given dashboard and endpoint. Identify the endpoint with urlHash or the full url (normalized and hashed server-side).
Parameters may be sent as query string and/or JSON body (body values win when both are present).
If this was the endpoint's last subscription in the organization, the unique-endpoint soft-limit slot is released. Related tokens and suppression for that endpoint are removed.
Requires the admin or subscriber role and the integrations feature entitlement.
Request
See API Basics for required headers.
Body / query parameters
| Field | Type | Required | Description |
|---|---|---|---|
dashboardId | uuid | Yes | Dashboard the subscription belongs to |
urlHash | string | Cond. | 64-character lowercase hex endpoint hash. Required if url is omitted. |
url | string | Cond. | Full HTTPS endpoint URL. Required if urlHash is omitted. |
Sample request
curl -X DELETE https://api.statusdashboard.com/app/integrations/webhooks/outbound/endpoints \
-H "Authorization: Bearer bcf847abf5c6:def456" \
-H "Content-Type: application/json" \
-d '{
"dashboardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"urlHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}'Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
400 | Invalid parameters, or neither urlHash nor url provided |
403 | Requires admin or subscriber role, or integrations disabled |
404 | Subscriber not found |

