---
title: "Remover webhook"
method: DELETE
path: "/v1/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Remover webhook

`DELETE /v1/webhooks/{webhookId}`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/webhooks/{webhookId}`
- Auth: HTTP bearer

Remove um webhook registrado. Após a remoção, nenhuma nova notificação será enviada
para o endpoint.

Requer scope `webhooks:write`.

## Path parameters

- `webhookId` string, required

## Response `204`

Webhook removido com sucesso.

## Other responses

- `401`: Autenticação ausente ou inválida.
- `403`: Permissões insuficientes para a operação solicitada. Inclui `purpose: "ACTION_AUTHENTICATION"` sem `featureFlags.trustSessionsEnabled`. A verificação é pelo `purpose`, não pela rota: vale em `/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`, além de `/v1/trust-sessions`. O remédio é habilitar a flag para o tenant e provisionar a cota `monthlyTrustSessions`.
- `404`: Recurso não encontrado.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)
