---
title: "Retrieve issue triggers"
method: GET
path: "/issue-triggers"
tags: ["Issue Triggers"]
---

# Retrieve issue triggers

`GET /issue-triggers`

This endpoint lists issue triggers.

## Query parameters

- `name` string — Filter by issue trigger name
- `type` union
  - 'delivery' | 'transformation' | 'backpressure' | 'request' — Issue type
  - IssueType[]
- `disabled_at` union — Date when the issue trigger was disabled
  - string, date-time, nullable
  - Operators
    - `gt` string, date-time, nullable
    - `gte` string, date-time, nullable
    - `le` string, date-time, nullable
    - `lte` string, date-time, nullable
    - `any` boolean
    - `all` boolean
- `order_by` union — Sort key(s)
  - 'created_at' | 'type'
  - string[]
- `dir` union — Sort direction(s)
  - 'asc' | 'desc'
  - string[]
- `limit` integer — Result set size
- `next` string — The ID to provide in the query to get the next set of results
- `prev` string — The ID to provide in the query to get the previous set of results

## Response `200`

List of issue triggers

- IssueTriggerPaginatedResult
  - `pagination` SeekPagination
    - `order_by` union
      - string
      - string[]
    - `dir` union
      - union
        - 'asc'
        - 'desc'
        - 'ASC'
        - 'DESC'
      - OrderByDirection[]
        - union
          - 'asc'
          - 'desc'
          - 'ASC'
          - 'DESC'
    - `limit` integer
    - `prev` string
    - `next` string
  - `count` integer
  - `models` 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.dev/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/revisions/091808eac7fa/schema)