Atualizar webhook

Atualiza URL, eventos ou estado sem trocar o segredo.

PATCH/webhooks/{id}webhooks:write

COMPORTAMENTO

A alteração é validada e persistida na conta da chave antes da resposta. Consulte o recurso retornado como fonte de verdade.

EFEITO

Pode alterar o recurso e emitir o evento de domínio correspondente.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

idstring · pathIdentificador do recurso.minLength 2 · maxLength 100obrigatório

namestring · bodyNome.opcional

urlstring · bodyURL HTTPS pública.uriopcional

eventsarray · bodyEventos ou *.opcional

activeboolean · bodyAtiva o destino.opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Escopowebhooks:write

Exemplo executável

curl

curl -X PATCH 'https://achadu.com/api/v1/webhooks/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "My integration",
  "url": "https://example.com/product",
  "events": [
    "offer.created"
  ]
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json

{
  "data": {
    "id": "wh_01J...",
    "name": "Production",
    "url": "https://example.com/webhooks/achadu",
    "events": [
      "offer.created"
    ],
    "active": true,
    "created_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}

200Operação concluída.

400Parâmetro, corpo ou transição inválida.

401Chave ausente, inválida, expirada ou revogada.

402O plano da conta não libera esta interface.

403A chave precisa do escopo webhooks:write.

404Recurso inexistente nesta conta.

409O estado atual impede esta operação.

413O corpo JSON ultrapassa 128 KB.

429A janela de 120 solicitações por minuto foi excedida.

Atualizar webhook

Solicitação

Exemplo executável

Resposta e erros

Operações relacionadas