Change a webhook endpoint (URL, events, versions, on/off)
PATCH/v1/webhooks/:webhook_id
enabled: true clears disabled_reason / disabled_at and restarts the auto-disable rule; deliveries dropped while disabled are not replayed automatically (use :redeliver).
Access: API key scope webhooks:write on a management key; portal users: organization admins and owners; refused for an API key limited to a list of knowledge bases (403 kb_not_in_allowlist).
Request
Responses
- 200
- 403
- 404
- 422
OK
scope_missing (details.required_scope), role_insufficient, kb_not_in_allowlist, integrations_disabled (details.area, details.scope), domain_blocked.
not_found — identical for missing resources and resources of another organization (details.resource).
validation_failed, webhook_url_rejected (details.rule), event_type_unknown, domain_invalid, method_not_allowed_for_domain.