PAGERDUTY_EDIT_WEBHOOK_SUBSCRIPTION_BY_ID

The UpdateWebhookSubscription endpoint allows you to modify an existing webhook subscription in PagerDuty. This PUT method enables users to update the events they want to be notified about, change the filter criteria for triggering notifications, update the subscription's description, and toggle its active state. It's particularly useful for adjusting notification preferences as your incident management needs evolve. The endpoint requires specifying the webhook subscription ID in the URL path and accepts a JSON body with the updated subscription details. Note that while you can update multiple aspects of the subscription, you must provide at least the 'events' array in your request. Be cautious when updating filters, as this can significantly change which incidents trigger notifications.

Available from 1 provider (1 remote)

Input Schema

            {
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "The ID of the resource."
    },
    "webhook__subscription__active": {
      "type": "boolean",
      "title": "Webhook  Subscription  Active",
      "description": "If true, a webhook will be sent. True is the default state. If false, a webhook will not be sent. "
    },
    "webhook__subscription__events": {
      "type": "array",
      "items": {
        "type": "string",
        "properties": {}
      },
      "title": "Webhook  Subscription  Events",
      "description": "The set of outbound event types the subscription will receive."
    },
    "webhook__subscription__filter__id": {
      "type": "string",
      "title": "Webhook  Subscription  Filter  Id",
      "description": "The id of the object being used as the filter.  This field is required for all filter types except account_reference. "
    },
    "webhook__subscription__description": {
      "type": "string",
      "title": "Webhook  Subscription  Description",
      "description": "A short description of the webhook subscription."
    },
    "webhook__subscription__filter__type": {
      "enum": [
        "account_reference",
        "service_reference",
        "team_reference"
      ],
      "type": "string",
      "title": "Webhook  Subscription  Filter  Type",
      "description": "The type of object being used as the filter."
    }
  }
}