Updates the specified webhook.
Activation
To activate a webhook, make a PATCH request with the active
property set to true
. By default, newly created webhooks are inactive by default and must be activated to start recieving events.
The following is a sample PATCH request to activate a webhook.
PATCH https://api.bentley.com/webhooks/{webhookId}
{
"active": true
}
Deactivation
To deactivate a webhook, make a PATCH request with the active
property set to false
. Once deactivated, your webhook will stop receiving events.
The following is a sample PATCH request to deactivate a webhook.
PATCH https://api.bentley.com/webhooks/{webhookId}
{
"active": false
}
Authentication
The Webhooks API V2 can only be called by Service Applications. This request requires an Authorization
header with a valid Bearer token with the webhooks:modify
scope. For more information on Service Applications and how to obtain an access token can be found here. A list of your Service Applications can be found here.
Authorization
The Service Application must have the webhooks_maintainer
permission assigned at the iTwin level or be an Organization Administrator for the Organization that owns a given iTwin.
An Organization Administrator must have at least one of the following roles assigned in User Management: Account Administrator, Co-Administrator, or CONNECT Services Administrator. For more information about User Management please visit our Bentley Communities Licensing, Cloud, and Web Services wiki page.