Pular para o conteúdo principal
PATCH
curl
Use este endpoint para alterar para onde um destino envia webhooks e quais eventos ele recebe.

Atualizando subscribed_events

Ao enviar subscribed_events, informe a lista completa de eventos que devem continuar assinados após a atualização. O array substitui o conjunto de assinaturas anterior.
Os valores aceitos são: As famílias de eventos do Investigator (investigator.*) e de Authentication (auth.*) também são aceitas; consulte Webhooks para ver a lista completa. Use o guia de criação de destino para ver descrições detalhadas dos eventos e conjuntos de assinaturas comuns.

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

destination_uuid
string<uuid>
obrigatório

UUID do destino a ser atualizado.

Corpo

application/json
label
string

Novo nome legível.

url
string<uri>

Nova URL de destino. Deve ser única dentro da aplicação.

enabled
boolean

Defina como false para pausar as entregas para este destino sem excluí-lo.

webhook_version
enum<string>

Nova versão do esquema do payload para entregas futuras.

Opções disponíveis:
v1,
v2,
v3
subscribed_events
enum<string>[]

Filtro de eventos deste destino do webhook. A Didit entrega apenas webhooks cujo tipo de evento corresponde exatamente a um destes valores; não existe assinatura curinga. Quando enviada, a lista deve conter pelo menos um evento válido (um [] explícito é rejeitado com 400); um destino cuja lista está vazia (campo omitido na criação) não recebe nada. Na atualização, a lista é substituída por inteiro, nunca mesclada.

Minimum array length: 1

Nome de evento de webhook compatível. Use exatamente estas strings em subscribed_events; valores não compatíveis são rejeitados.

Opções disponíveis:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
Exemplo:

Resposta

Destino do webhook atualizado. O corpo tem o mesmo formato de GET /v3/webhook/destinations/{destination_uuid}/.

uuid
string<uuid>
label
string
url
string<uri>
enabled
boolean
webhook_version
enum<string>
Opções disponíveis:
v1,
v2,
v3
secret_shared_key
string
secret_last4
string

Últimos quatro caracteres do segredo de assinatura atual do destino, para que você possa distinguir os segredos. Não é suficiente para verificar uma assinatura.

previous_secret_expires_at
string<date-time> | null

Definido por 24 horas após a rotação do segredo de assinatura do destino no Business Console. Até esse momento, toda entrega ao destino também inclui X-Signature-Previous, X-Signature-V2-Previous e X-Signature-Simple-Previous, gerados com o segredo substituído (consulte Verificação de assinatura). null quando nenhuma rotação ocorreu nas últimas 24 horas.

subscribed_events
enum<string>[]

Filtro de eventos deste destino do webhook. A Didit entrega apenas webhooks cujo tipo de evento corresponde exatamente a um destes valores; não existe assinatura curinga. Quando enviada, a lista deve conter pelo menos um evento válido (um [] explícito é rejeitado com 400); um destino cuja lista está vazia (campo omitido na criação) não recebe nada. Na atualização, a lista é substituída por inteiro, nunca mesclada.

Minimum array length: 1

Nome de evento de webhook compatível. Use exatamente estas strings em subscribed_events; valores não compatíveis são rejeitados.

Opções disponíveis:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
Exemplo:
created_by_email
string | null

E-mail do membro do Business Console que criou o destino. null para um destino criado com uma chave de API.

created_by_name
string | null

Nome do membro do Business Console que criou o destino. null para um destino criado com uma chave de API.

created_at
string<date-time>
updated_at
string<date-time>
health_status
enum<string>

Saúde das entregas. failing: 3 ou mais eventos consecutivos falharam na primeira tentativa de entrega desde a última vez que o destino respondeu com sucesso (consulte failing_streak). degraded: não está em falha, mas uma tentativa de entrega falhou nas últimas 24 horas e nenhuma tentativa posterior entregou esse evento; uma nova tentativa ou um reenvio que o entregue remove esse estado. healthy: nenhum dos dois. Independe de enabled. Uma tentativa com falha é aquela respondida com HTTP 400 ou superior, ou que não recebeu resposta.

Opções disponíveis:
healthy,
degraded,
failing
failing_streak
integer

Quantos eventos consecutivos falharam na primeira tentativa de entrega desde a última resposta bem-sucedida do destino, nos últimos 30 dias. Novas tentativas não são contadas, e qualquer tentativa bem-sucedida, incluindo uma nova tentativa ou um reenvio, encerra a sequência. 0 quando nenhum evento falhou desde o último sucesso.

failing_since
string<date-time> | null

Quando foi feita a primeira tentativa com falha do failing_streak atual. null quando failing_streak é 0.

last_success_at
string<date-time> | null

Quando o destino respondeu pela última vez a uma entrega com um status HTTP abaixo de 400, nos últimos 30 dias. null se isso não ocorreu nesse período.

environment
enum<string>

Ambiente da aplicação proprietária do destino.

Opções disponíveis:
live,
sandbox
summary
object

Métricas de entrega dos últimos metrics_window_days (30) dias. last_delivery_at é a tentativa mais recente, independentemente de quando foi feita.

Última modificação em 1 de novembro de 2026