webhookId is passed as a URL path parameter. Changes take effect immediately — disabling a webhook stops event delivery until you re-enable it. Events that occur while the webhook is disabled are not queued and are not sent after you re-enable it. A deleted webhook cannot be updated.
All requests must include the
X-BH-TOKEN header and Content-Type: application/json.Endpoint
PUT https://api.velafi.com/v2/webhook/{webhookId}
Path Parameter
string
required
The unique ID of the webhook to update. Obtain this from the Create Webhook or List Webhooks response.
Request Parameters
string
Optional. The new callback URL for this webhook. It must start with
http. If omitted, the URL is unchanged.number
Optional. Updated status for the webhook:
10 = active, 20 = disabled. 30 is rejected — use Delete Webhook instead. If omitted, the status is unchanged.Response Fields
number
HTTP-style response code.
200 indicates success.string
Human-readable status message, e.g.
SUCCESS.object
Example
cURL
Response
You cannot change the
eventType of an existing webhook. To listen to a different event, create a new webhook and delete the old one.