---
title: "Retire an endpoint (soft; its delivery history is kept)"
method: DELETE
path: "/v1/webhooks/{endpointId}"
tags: ["Webhooks"]
---

# Retire an endpoint (soft; its delivery history is kept)

`DELETE /v1/webhooks/{endpointId}`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/webhooks/{endpointId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Retires the organisation's webhook endpoint from future event delivery while preserving its existing delivery history.

## Response `204`

Retired

## Other responses

- `401`: Problem response
- `403`: Problem response
- `404`: Problem response

---

[API](https://skmtc.dev/ironfang/apis/ironfang-audit-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-audit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-audit-api/revisions/7430deff2cbd?raw)