Update a webhook
update_webhookChange a webhook's URL, events, headers, description, or enabled state, or rotate its signing secret. Use it to fix delivery targets, update filters, or revoke a leaked secret immediately.
Instructions
Change a webhook's URL, events, description or headers, turn it off or back on, or replace its signing secret (rotate_secret: the old one stops working at once and the new one is in the answer). Turning it off drops what it still had waiting.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The new URL, whole. A public https URL (not a private, local or internal address). A key in it is fine (?token=…, or one in the path): the URL is kept sealed and shown back with its keys masked. user:password@ before the host is sent as an Authorization: Basic header instead. | |
| events | No | ||
| enabled | No | ||
| headers | No | Replaces all of the webhook's own headers ({} removes them). Headers of your own to send on every request, as { name: value }, for a receiver that checks who's calling: e.g. { "Authorization": "Bearer <key>" } or { "X-Api-Key": "<key>" }, exactly as the receiver's setup gives them. Sent alongside Parley's own headers and signature; kept sealed, and only each name and the value's last 4 characters are ever shown back. At most 10; Parley's own (Parley-*, Webhook-*, Content-Type, User-Agent, Host…) can't be set. | |
| webhook_id | Yes | ||
| description | No | ||
| rotate_secret | No |