# DELETE /v1/webhook-endpoints/:endpointId (/docs/api/reference/webhooks/delete-endpoint)



<Endpoint method="DELETE" path="/v1/webhook-endpoints/{endpointId}" auth="X-Api-Key" phase="1" />

Removes the endpoint and cascade-deletes its delivery history. Pending deliveries queued against this endpoint are abandoned (will not fire and will not retry). If you want to stop deliveries temporarily without losing the signing secret or delivery log, use [`PATCH status: "paused"`](/docs/api/reference/webhooks/update-endpoint) instead.

## Example [#example]

```bash
curl -X DELETE https://api.layers.com/v1/webhook-endpoints/d4c71b62-... \
  -H "X-Api-Key: $LAYERS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

<Response status="200" description="OK">
  ```json
  { "id": "d4c71b62-7f08-4dc9-9d2c-8f7e2b9c4411", "deleted": true }
  ```
</Response>

## Errors [#errors]

| Status | Code        | When                                   |
| ------ | ----------- | -------------------------------------- |
| 404    | `NOT_FOUND` | Endpoint not owned by the calling org. |