Update Webhook
Updates the description, callback URL, or subscribed events of a Webhook. Omitted fields remain unchanged.
Prerequisites
Endpoint and authentication configured. For details, see Overview and authentication.
Endpoint
PUT /webhook_endpoints/{id}
Path parameters
id string (必选)
Webhook ID, format wep_<ULID>
Request bodydescription Max 256 characters; url New callback URL; re-validated when provided; private, loopback, link-local, and reserved addresses are rejected events Replaces the entire subscription list with named event types; omitted means unchanged | Request example |
Response fieldsid — description — url — events — status — disabled_reason — consecutive_fail Current value at the time of update last_success_at Current value at the time of update last_failure_at Current value at the time of update created_at — updated_at — request_id Unique identifier for this request; include it when troubleshooting | Response |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 400 | 11800016 | invalid webhook request |
| 404 | 11800001 | webhook not found |