Edits the information of a specific subscription.
PUT {{baseUrl}}/api/notifications/subscriptions/:subscriptionId
Note for webhook-based subscriptions: When changing the webhook's DeliveryContext or DeliveryUrl value, a synchronous validation call to the webhook DeliveryUrl will be made. The webhook has to respond successfully and with the expected ValidationResponse value in the response (the value must match the ValidationContext value provided in the webhook request). Otherwise the subscription will not be modified and an error is returned.
See the subchapter about Webhook Calls: Validation Message
in the webhook section of the Notifications Guide for more information.
Request Body
{"DeliveryType"=>"webhook", "EventTypes"=>["Endpoint.FileDetection"], "Webhook"=>{"DeliveryContext"=>"MyCustomCorrelationString", "DeliveryRateInSeconds"=>90, "DeliveryUrl"=>"https://my.company.com/wrunity/notifications/webhook"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"SubscriptionId":"cf5447ea-cc12-48ad-b593-5c21afb5b0bb","DeliveryType":"webhook","Domain":{"Type":"Site","Values":[{"Name":"GSMKey","Value":"81F4-B89C-4FED-490A-92B0"},{"Name":"SiteKey","Value":"D6C2-ECAE-663C-4C33-8890"}]},"EventTypes":["Endpoint.FileDetection"],"Webhook":{"DeliveryContext":"MyCustomCorrelationString","DeliveryRateInSeconds":90,"DeliveryUrl":"https://my.company.com/wrunity/notifications/webhook","Suspended":false,"Statistics":null},"CreatedDate":"2022-08-29T10:36:07.0442767Z","UpdatedDate":"2022-11-29T10:34:07.0442767Z"}