Update a webhook endpoint
Changes the URL, events, agents, content setting or status. Send the endpoint’s current revision in the body; if it changed meanwhile you get 409.
Scopes: webhook:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Path Parameters
Body
The endpoint's revision you read, so a stale edit is refused.
x >= 1A new HTTPS URL.
2048Replaces the event list.
1 - 60 elementsA new label.
1 - 120A new note.
280Replaces the agent filter.
50Turn conversation content in payloads on or off.
Turn the endpoint off or on.
active, disabled Response
Successful Response
The endpoint id.
Where events are sent.
active or disabled.
The event types (or patterns) it receives.
The last characters of the signing secret.
Send this back as revision on an update.
ISO 8601 time it was created.
ISO 8601 time it last changed.
The endpoint's label.
A note for your team.
Why Kallabot turned it off, when it did.
Only events about these agents; empty is all.
Whether payloads carry conversation content.
The event payload version this endpoint receives.
standard (Standard Webhooks whsec_…) or legacy (rotate it).
When the previous secret stops signing, during a rotation's grace period.
Deliveries failed in a row.
When the current run of failures started.
The last successful delivery.
The signing secret. Only on create and rotate, and never on a replay.