Changelog API Grafeno: 2026-08-25

Improved: [API de Webhooks] Atualização parcial de URL e Header via PATCH

O que mudou

Campo	Descrição
`url`	Endereço de destino do webhook. Pode ser atualizado de forma independente, sem necessidade de reenviar os demais campos.
`extraHeaders`	Cabeçalho de autenticação vinculado ao webhook. Pode ser atualizado ou removido (enviando `null`) sem afetar a URL configurada.

O endpoint de atualização de webhook agora suporta atualização parcial via PATCH, permitindo enviar apenas os atributos que deseja modificar.

O webhook permanece ativo durante e após a atualização, sem necessidade de desativação prévia.

Exemplo de requisição

curl --request PATCH \
     --url https://pagamentos.grafeno.digital/api/v2/webhooks/{{webhook_uuid}}/update_state \
     --header 'Account-Number: 00123456-7' \
     --header 'Authorization: TOKEN_DE_API' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
              "url": "https://novo-dominio.com.br/webhook",
              "extraHeaders": "{\"Authorization-new\":\"SEU_NOVO_HEADER_AQUI\"}"
             }'

Compatibilidade

Essa é uma mudança retrocompatível: o comportamento atual do endpoint (ativação/desativação de webhooks) não é impactado. Integrações existentes continuam funcionando normalmente.

Acesse a especificação técnica da API de webhooks Grafeno para obter informações sobre como utilizar este recurso.