Update a webhook subscription’s url, events, filters, or status. Each field you include is replaced wholesale (a partial update at the top level, not a deep merge): sending filters replaces the entire filters object — e.g. PATCH { "filters": { "only_my_bubbles": false } } drops a previously-set bubble_types — and an empty { "filters": {} } clears all filters. Omit a field to leave it unchanged. status accepts "active" only — used to re-enable a subscription auto-disabled after repeated delivery failures; there is no manual disable. Requires the webhooks:manage scope.

patch/v1/webhooks/{id}

Request

idstring required

Resource id (bubbles also accept the short id used in app URLs).

urlstring

A new receiver URL.

eventsstring[]

A new event set.

status'active'

Set to "active" to re-enable an auto-disabled subscription.

Success.

idstring required

The subscription id (wh_…).

urlstring required

The receiver URL deliveries are POSTed to.

eventsstring[] required

Subscribed event types (bubble.ready | meeting_recording.ready | screen_recording.ready).

team_idstring nullable required

Team scope, or null (all teams).

space_idstring nullable required

Channel scope, or null.

status'active' | 'disabled' required

Delivery status; auto-disabled after repeated failures.

created_atstring required

Creation instant (ISO-8601 UTC).

last_success_atstring nullable required

Last successful delivery instant, or null.

last_failure_atstring nullable required

Last failed delivery instant, or null.

disabled_atstring nullable required

When the subscription was disabled, or null.

disabled_reasonstring nullable required

Why it was disabled (e.g. delivery_failures), or null.

No recorded changes to this operation across all 1 revision of this API.