Update a webhook endpoint
Changes the URL, event types, description or payload version. Send status: "disabled" to stop deliveries to the endpoint, or status: "enabled" to resume them, also after the health rule disabled it; re-enabling clears fail_since and the health rule starts fresh.
Authorizations
Use Authorization: Bearer end_sk_* for partner API keys (e.g. end_sk_AbCd_example_api_key).
Path Parameters
"8e1a7f50-90ab-4cde-8012-3456789abcde"
Body
HTTPS URL on a public host.
2048"https://hooks.example.com/endstate"
1 - 64 elements1512Dated payload version; must be the current version or an older one the platform still renders.
^\d{4}-\d{2}-\d{2}$"2026-09-01"
Send disabled to stop deliveries to the endpoint, or enabled to resume them; recover then resends what was missed.
enabled, disabled Response
The updated endpoint.
"8e1a7f50-90ab-4cde-8012-3456789abcde"
HTTPS URL that receives deliveries.
"https://hooks.example.com/endstate"
Event types this endpoint is subscribed to.
disabled on the first failed delivery after fail_since is five days old, after a 410 response, or when deleted. Re-enable with PATCH.
enabled, disabled "enabled"
When the current run of failed deliveries began, or null while deliveries succeed. The next failed delivery after this is five days old disables the endpoint, so fix the receiver before then.
null
Dated payload version this endpoint receives.
"2026-09-01"

