Skip to main content
PATCH
Update a webhook
Partially updates a webhook. Only the fields you send are changed. The signing secret cannot be changed here. Use Rotate. Returns the updated webhook object.

Path parameters

string
required
The webhook’s id (UUID).

Request body

string
New target URL. Must be https:// and publicly reachable. It is verified with a HEAD request before the change is saved, and the old URL is kept if verification fails.
string[]
Replacement list of event types, or ["*"] for the session.status_updated firehose.
string
New label (max 255 characters).
boolean
Set true to pause deliveries without deleting the webhook. Setting false re-enables a webhook that was disabled automatically after repeated delivery failures.

Examples


Errors

Last modified on September 11, 2026