# Editar webhook > Editar webhook: PATCH /v1/webhooks/:id. Muda url, events ou active; só vai o que mudou. Pausar descarta as entregas pendentes; reativar zera a contagem de falhas. Fonte: https://praeko.app/docs/api/webhooks/update-webhook `PATCH /v1/webhooks/:id` · escopo mínimo: admin Muda `url`, `events` ou `active`; só vai o que mudou. Pausar descarta as entregas pendentes; reativar zera a contagem de falhas. > **Cabeçalhos** `Authorization: Bearer praeko_…` e `X-Praeko-Contract: en`. Sempre envie os dois. ## Parâmetros | Nome | Onde | Descrição | |---|---|---| | `id` | caminho | Id do webhook (começa com `wh_`). | | `Idempotency-Key` | cabeçalho | Chave de idempotência (1 a 255 caracteres visíveis, por exemplo um UUID). Repetir o MESMO pedido com a mesma chave, em até 24 h, devolve a resposta guardada (com `Idempotent-Replayed: true`) sem executar de novo; outro pedido com a mesma chave dá 422 `idempotency_key_reuse`; um pedido ainda em andamento dá 409 `idempotency_in_progress`. Erros 5xx não são guardados. A chave vale por workspace e por rota. Veja [Repetir uma requisição](https://praeko.app/docs/guides/idempotency). | ## Corpo da requisição JSON. Campos obrigatórios precisam ir; os outros podem ser omitidos. Envie só os campos que quer mudar; um corpo `{}` não muda nada. | Campo | Tipo | Descrição | |---|---|---| | `url` (opcional) | texto | Novo endereço (as mesmas regras de `POST /v1/webhooks`). Sem ele, a url não muda. Até 2048 caracteres. | | `events` (opcional) | string[] | Nova lista de eventos (substitui a anterior; pelo menos um). Sem ela, não muda. Valores: post.sent, post.failed, post.scheduled-fail. | | `active` (opcional) | verdadeiro/falso | `false` pausa (as entregas pendentes são descartadas); `true` reativa e zera a contagem de falhas seguidas. | **Exemplo de corpo** ```json { "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true } ``` ## Exemplo **curl** ```bash curl -X PATCH "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R" \ -H "Authorization: Bearer $PRAEKO_KEY" \ -H "X-Praeko-Contract: en" \ -H "Content-Type: application/json" \ -d '{ "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true }' ``` **JavaScript** ```js const res = await fetch("https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R", { method: "PATCH", headers: { "Authorization": `Bearer ${process.env.PRAEKO_KEY}`, "X-Praeko-Contract": "en", "Content-Type": "application/json", }, body: JSON.stringify({ "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true }), }); console.log(res.status, await res.json()); ``` **Node** ```js import { Praeko } from "@praeko/sdk"; const praeko = new Praeko({ url: "https://praeko.app", key: process.env.PRAEKO_KEY }); const resultado = await praeko.webhooks.update("wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R", {"events":["post.sent","post.failed","post.scheduled-fail"],"active":true}); console.log(resultado); ``` **Python** ```python import os import requests resp = requests.patch( "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R", headers={ "Authorization": f"Bearer {os.environ['PRAEKO_KEY']}", "X-Praeko-Contract": "en", }, json={ "events": [ "post.sent", "post.failed", "post.scheduled-fail", ], "active": True, }, ) print(resp.status_code, resp.json()) ``` **PHP** ```php 'PATCH', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("PRAEKO_KEY"), 'X-Praeko-Contract: en', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => $corpo, ]); $resposta = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), " ", $resposta, PHP_EOL; curl_close($ch); ``` **Go** ```go package main import ( "fmt" "io" "net/http" "os" "strings" ) func main() { body := strings.NewReader(`{ "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true }`) req, err := http.NewRequest("PATCH", "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R", body) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("PRAEKO_KEY")) req.Header.Set("X-Praeko-Contract", "en") req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) } ``` **Ruby** ```ruby require "net/http" require "uri" uri = URI("https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R") request = Net::HTTP::Patch.new(uri) request["Authorization"] = "Bearer #{ENV['PRAEKO_KEY']}" request["X-Praeko-Contract"] = "en" request["Content-Type"] = "application/json" request.body = <<~'JSON' { "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true } JSON response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) } puts response.code, response.body ``` **C#** ```csharp using System.Net.Http; using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); using var request = new HttpRequestMessage(HttpMethod.Patch, "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PRAEKO_KEY")); request.Headers.Add("X-Praeko-Contract", "en"); request.Content = new StringContent(""" { "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true } """, Encoding.UTF8, "application/json"); using var response = await client.SendAsync(request); Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}"); ``` **Java** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { String body = """ { "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true } """; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R")) .header("Authorization", "Bearer " + System.getenv("PRAEKO_KEY")) .header("X-Praeko-Contract", "en") .header("Content-Type", "application/json") .method("PATCH", HttpRequest.BodyPublishers.ofString(body)) .build(); HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body()); } } ``` **HTTPie** ```bash http PATCH "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R" \ "Authorization: Bearer $PRAEKO_KEY" \ "X-Praeko-Contract: en" \ "Content-Type: application/json" \ --raw='{ "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true }' ``` > SDK oficial para Node: Instale com `npm install @praeko/sdk` (veja [SDK e CLI](https://praeko.app/docs/sdk)). ## Resposta | Status de sucesso | Quando | |---|---| | `200` | Sucesso. | **Resposta 200** ```json { "id": "wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R", "url": "https://exemplo.com.br/hooks/praeko", "events": [ "post.sent", "post.failed", "post.scheduled-fail" ], "active": true, "secretHint": "whsec_…k3Qw", "consecutiveFailures": 0, "createdAt": "2026-11-07T14:02:11.482Z", "updatedAt": "2026-11-07T14:02:11.482Z" } ``` ## Erros | Status | code | Quando | |---|---|---| | 400 | `empty_body` | O corpo veio vazio. | | 400 | `invalid_json` | O corpo não é um objeto JSON. | | 413 | `body_too_large` | O corpo passa de 1 MB. | | 404 | `webhook_not_found` | O webhook não existe neste workspace. | | 422 | `invalid_field` | `events` vazio ou com evento desconhecido. | | 422 | `unsafe_url` | A nova url não é aceita. | | 422 | `idempotency_key_reuse` | A `Idempotency-Key` já foi usada com outro pedido (método, caminho, query ou corpo diferentes). | | 409 | `idempotency_in_progress` | Um pedido com a mesma `Idempotency-Key` ainda está em andamento (repita em instantes). | | 409 | `idempotency_response_too_large` | A resposta original passou de 256 KB e não foi guardada; consulte o recurso por GET. | ### Erros de qualquer rota | Status | code | Quando | |---|---|---| | 401 | `unauthorized` | Faltou o cabeçalho `Authorization: Bearer …`. | | 401 | `invalid_api_key` | A chave não existe. | | 401 | `revoked_api_key` | A chave foi revogada. | | 401 | `expired_api_key` | A chave expirou. | | 403 | `forbidden` | O escopo da chave não basta para esta rota (veja o selo de escopo). | | 429 | `rate_limited` | Passou do limite de requisições por minuto. | O corpo de todo erro é `{ "error": { "code", "message", "details"? } }`. Veja [todos os códigos](https://praeko.app/docs/guides/errors-and-limits). ## Testar > **Testar**: o teste ao vivo exige entrar na conta. Aqui ele fica desligado.