Skip to main content
PUT

Visão Geral

Atualiza uma configuração de webhook existente. Todos os campos são opcionais — apenas os campos fornecidos serão atualizados.

Endpoint

string
obrigatório
UUID do agente
string
obrigatório
UUID do webhook

Requisição

Resposta

boolean
Indica se o webhook foi atualizado com sucesso
string
Mensagem de sucesso
object
Objeto do webhook atualizado
string
Identificador único do webhook
string
UUID do agente ao qual este webhook pertence
string
Nome atualizado do webhook
string
URL atualizada do webhook
array
Array atualizado de tipos de evento configurados
integer
Timeout atualizado da requisição em segundos
integer
Tentativas máximas de retry atualizadas
boolean
Status atualizado do webhook
string
Timestamp ISO 8601 quando o webhook foi criado
string
Timestamp ISO 8601 quando o webhook foi atualizado pela última vez
integer
Número de eventos configurados para este webhook
string
Status atual do webhook

Respostas de erro

Regras de validação

  • name: Opcional, string, máximo de 255 caracteres
  • webhook_url: Opcional, URL válida, máximo de 500 caracteres
  • webhook_secret: Opcional, string, máximo de 255 caracteres
  • events: Opcional, array com mínimo de 1 evento, cada evento deve estar na lista de eventos disponíveis
  • timeout: Opcional, inteiro entre 5-120 segundos
  • max_retries: Opcional, inteiro entre 0-10
  • enabled: Opcional, booleano

Observações importantes

  • Todos os campos são opcionais — apenas os campos fornecidos serão atualizados
  • Operações de webhook limpam automaticamente o cache do agente para efeito imediato
  • Use endpoints HTTPS para URLs de webhook em produção
  • Implemente verificação adequada de assinatura usando o webhook secret para segurança

Endpoints relacionados