# Delete webhook endpoint

Remove an outbound webhook subscription from a dashboard.

Source: https://statusdashboard.com/docs/api/integrations/webhooks/outbound/endpoints/delete

`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](/docs/api) 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
```bash
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                                        |