> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Elimina webhook

> Elimina un webhook e le sue consegne

Elimina un webhook, i suoi secret e le sue consegne. Questa azione non può essere annullata. Per mettere in pausa un
webhook, invia `status: "disabled"` con [Aggiorna webhook](https://docs.anivahealth.com/it/api/webhooks/update-webhook.md).

> [!NOTE]
>
> Richiede lo scope `webhooks_manage`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore del webhook (UUID).

## Risposta

In caso di successo, l'API restituisce `204 No Content` con un corpo vuoto.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Richiesta non valida. Vedi il messaggio `error`. |
| `401` | Chiave API non valida. |
| `403` | Nessuna chiave API, oppure chiave API senza lo scope `webhooks_manage`. |
| `404` | Webhook non trovato, oppure appartiene a un'altra chiave API. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/webhooks/4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 404 theme={null}
{
  "error": "Webhook not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.