DELETE /api/webhooks/:id
Remove permanentemente um webhook. Após a exclusão, nenhum evento será mais entregue ao endpoint configurado.
Autenticação
Scope necessário: webhooks:write
Inclua o header Authorization: Bearer <api-key> ou use cookie de sessão.
Requisição
DELETE /api/webhooks/:id
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | sim | Bearer pk_... (API key) ou cookie de sessão |
Parâmetros de rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | sim | UUID do webhook |
Exemplo
curl -X DELETE "https://api.placaflow.com.br/api/webhooks/w1b2c3d4-5678-9abc-def0-123456789abc" \
-H "Authorization: Bearer pk_a1b2c3d4e5f6g7h8i9j0..."
Resposta 200
{
"success": true
}
Atenção
A exclusão é irreversível. Eventos pendentes que ainda não foram entregues serão descartados. O secret do webhook será invalidado imediatamente.
Erros
| Código | Descrição |
|---|---|
| 401 | Não autenticado ou API key inválida |
| 403 | API key não possui scope webhooks:write |
| 404 | Webhook não encontrado |