Permissões de configuração

Um webhook de projeto exige administração desse projeto. Um webhook global e o inventário organizacional exigem administração da organização conforme as políticas do backend. Estas são operações JWT da API privada.

MétodoRota relativa a /api/v1/organizations/{orgId}
POST/webhooks
GET/webhooks
GET / PUT / DELETE/webhooks/{id}
GET/webhooks/{id}/deliveries?page=1&pageSize=20

Na criação, envie projectId opcional, url, secret opcional e eventTypes opcional. O servidor gera um segredo se ele não for informado. O segredo completo só acompanha a criação; leituras posteriores não o devolvem.

Atualize a configuração

O PUT recebe url, eventTypes e active. Ele não é um PATCH parcial e não oferece mudança de segredo. Revise os valores ao desativar ou editar o destino.

Investigue falhas

Consulte o histórico na configuração de integrações do projeto. Confira URL, assinatura no receptor, status HTTP e tentativas. Destinos inválidos, integração removida ou inativa e restrições de acesso podem produzir estados diferentes de uma falha HTTP comum.

A implementação mantém um identificador estável por entrega. Uma repetição manual deve operar sobre a entrega específica; não reenvie um lote inteiro para compensar um único destino.