---
title: "Update an issue trigger"
method: PUT
path: "/issue-triggers/{id}"
tags: ["Issue Triggers"]
---

# Update an issue trigger

`PUT /issue-triggers/{id}`

This endpoint updates an issue trigger.

## Path parameters

- `id` string, required — Issue trigger ID

## Request body

- object
  - `configs` union — Configuration object for the specific issue type selected
    - IssueTriggerDeliveryConfigs — Configurations for a 'delivery' issue trigger
      - `strategy` 'first_attempt' | 'final_attempt', required — The strategy uses to open the issue
      - `connections` union, required — A pattern to match on the connection name or array of connection IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerTransformationConfigs — Configurations for a 'Transformation' issue trigger
      - `log_level` 'debug' | 'info' | 'warn' | 'error' | 'fatal', required — The minimum log level to open the issue on
      - `transformations` union, required — A pattern to match on the transformation name or array of transformation IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerBackpressureConfigs — Configurations for a 'Backpressure' issue trigger
      - `delay` integer, required — The minimum delay (backpressure) to open the issue for min of 1 minute (60000) and max of 1 day (86400000)
      - `destinations` union, required — A pattern to match on the destination name or array of destination IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerRequestConfigs — Configurations for a 'Request' issue trigger
      - `rejection_causes` union, required — An array of rejection causes to match on, or '*' to match all rejection causes.
        - '*'
        - RequestRejectionCause[]
      - `excluded_rejection_causes` RequestRejectionCause[] — Optional array of rejection causes to exclude. When specified, rejection_causes must be '*'. This allows matching all causes EXCEPT the specified ones.
      - `sources` union, required — A pattern to match on the source name or array of source IDs. Use `*` as wildcard.
        - string
        - string[]
  - `channels` IssueTriggerChannels, nullable — Notification channels object for the specific channel type
    - `slack` IssueTriggerSlackChannel — Channel for a 'Slack' issue trigger
      - `channel_name` string, required
    - `microsoft_teams` IssueTriggerMicrosoftTeamsChannel — Channel for a 'Microsoft Teams' issue trigger
      - `channel_name` string, required
    - `discord` IssueTriggerDiscordChannel — Channel for a 'Discord' issue trigger
      - `channel_name` string, required
      - `channel_id` string, required
      - `webhook_url` string
    - `betteruptime` IssueTriggerBetterUptimeChannel — Channel for a 'Better Uptime' issue trigger
      - `escalation_policy_id` string, required
      - `escalation_policy_name` string, required
    - `incidentio` IssueTriggerIncidentIoChannel — Channel for an 'incident.io' issue trigger
      - `severity_id` string
      - `severity_name` string
    - `pagerduty` IssueTriggerIntegrationChannel — Integration channel for an issue trigger
    - `opsgenie` IssueTriggerIntegrationChannel — Integration channel for an issue trigger
    - `email` IssueTriggerEmailChannel — Email channel for an issue trigger
  - `disabled_at` string, date-time, nullable — Date when the issue trigger was disabled
  - `name` string, nullable — Optional unique name to use as reference when using the API

## Response `200`

A single issue trigger

- IssueTrigger
  - `id` string, required — ID of the issue trigger
  - `team_id` string, nullable — ID of the project
  - `name` string, nullable — Optional unique name to use as reference when using the API
  - `type` 'delivery' | 'transformation' | 'backpressure' | 'request', required — Issue type
  - `configs` union, required — Configuration object for the specific issue type selected
    - IssueTriggerDeliveryConfigs — Configurations for a 'delivery' issue trigger
      - `strategy` 'first_attempt' | 'final_attempt', required — The strategy uses to open the issue
      - `connections` union, required — A pattern to match on the connection name or array of connection IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerTransformationConfigs — Configurations for a 'Transformation' issue trigger
      - `log_level` 'debug' | 'info' | 'warn' | 'error' | 'fatal', required — The minimum log level to open the issue on
      - `transformations` union, required — A pattern to match on the transformation name or array of transformation IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerBackpressureConfigs — Configurations for a 'Backpressure' issue trigger
      - `delay` integer, required — The minimum delay (backpressure) to open the issue for min of 1 minute (60000) and max of 1 day (86400000)
      - `destinations` union, required — A pattern to match on the destination name or array of destination IDs. Use `*` as wildcard.
        - string
        - string[]
    - IssueTriggerRequestConfigs — Configurations for a 'Request' issue trigger
      - `rejection_causes` union, required — An array of rejection causes to match on, or '*' to match all rejection causes.
        - '*'
        - RequestRejectionCause[]
      - `excluded_rejection_causes` RequestRejectionCause[] — Optional array of rejection causes to exclude. When specified, rejection_causes must be '*'. This allows matching all causes EXCEPT the specified ones.
      - `sources` union, required — A pattern to match on the source name or array of source IDs. Use `*` as wildcard.
        - string
        - string[]
  - `channels` IssueTriggerChannels, nullable — Notification channels object for the specific channel type
    - `slack` IssueTriggerSlackChannel — Channel for a 'Slack' issue trigger
      - `channel_name` string, required
    - `microsoft_teams` IssueTriggerMicrosoftTeamsChannel — Channel for a 'Microsoft Teams' issue trigger
      - `channel_name` string, required
    - `discord` IssueTriggerDiscordChannel — Channel for a 'Discord' issue trigger
      - `channel_name` string, required
      - `channel_id` string, required
      - `webhook_url` string
    - `betteruptime` IssueTriggerBetterUptimeChannel — Channel for a 'Better Uptime' issue trigger
      - `escalation_policy_id` string, required
      - `escalation_policy_name` string, required
    - `incidentio` IssueTriggerIncidentIoChannel — Channel for an 'incident.io' issue trigger
      - `severity_id` string
      - `severity_name` string
    - `pagerduty` IssueTriggerIntegrationChannel — Integration channel for an issue trigger
    - `opsgenie` IssueTriggerIntegrationChannel — Integration channel for an issue trigger
    - `email` IssueTriggerEmailChannel — Email channel for an issue trigger
  - `disabled_at` string, date-time, nullable — ISO timestamp for when the issue trigger was disabled
  - `updated_at` string, date-time, required — ISO timestamp for when the issue trigger was last updated
  - `created_at` string, date-time, required — ISO timestamp for when the issue trigger was created
  - `deleted_at` string, date-time, nullable — ISO timestamp for when the issue trigger was deleted

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.net/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/versions/31da4ed27d31/schema)