# Get Triggers Associated with a Recipient

List all triggers that will alert a given Recipient.  This request will return all Triggers associated with the specific Recipient across your entire Honeycomb team rather than being scoped to a dataset or environment.


Endpoint: GET /1/recipients/{recipientId}/triggers
Version: 1.0.0
Security: configuration_key

## Path parameters:

  - `recipientId` (string, required)
    Unique identifier (ID) of a Recipient.

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier (ID) for this Trigger.

  - `dataset_slug` (string)
    The slug of the dataset this trigger belongs to. For environment-wide triggers, this will be "__all__".

  - `name` (string)
    A short, human-readable name for this Trigger, which will be displayed in the UI and when the trigger fires.

  - `description` (string)
    A longer description, displayed on the Trigger's detail page.

  - `tags` (array)
    A list of key-value pairs to help identify the Trigger.
    Example: [{"key":"team","value":"blue"}]

  - `tags.key` (string, required)
    A key to identify the tag, lowercase letters only.

  - `tags.value` (string, required)
    A value for the tag, must begin with a lowercase letter, contain only alphanumeric characters (all letters lowercase) and special characters of  and  allowed.

  - `threshold` (object)
    The threshold over which the trigger will fire, specified as both an operator and a value.

  - `threshold.op` (string, required)
    Enum: ">", ">=", "<", "<="

  - `threshold.value` (number, required)

  - `threshold.exceeded_limit` (integer)
    The number of times the threshold must be met before an alert is sent.

  - `frequency` (integer)
    The interval in seconds in which to check the results of the query’s calculation against the threshold. Cannot be more than 4 times the query's duration (i.e. ). See [A Caveat on Time](https://docs.honeycomb.io/investigate/collaborate/share-query/define-query-json/#how-to-specify-an-absolute-time-range) for more information on specifying a query's duration. minimum: 60 maximum: 86400 multipleOf: 60 default: 900

  - `alert_type` (string)
    How often to fire an alert when a trigger threshold is crossed.
-  sends a trigger notification when the result of the specified calculation crosses the threshold.
  The trigger resolves only when the result of the query no longer satisfies the threshold condition.
-  keeps sending a trigger notification at current frequency when and while the threshold is met.
  (This reflects the same behavior as the "Send an alert every time a threshold is met" checkbox in the Honeycomb UI.)
    Enum: "on_change", "on_true"

  - `disabled` (boolean)
    If true, the trigger will not be evaluated and alerts will not be sent.

  - `triggered` (boolean)
    If true, the trigger has crossed its specified threshold without resolving.

  - `recipients` (array)
    A list of [Recipients](/api/recipients/) to notify when the Trigger fires. Using + is deprecated. First, create the Recipient via the Recipients API, and then specify the ID.

  - `recipients.id` (string)

  - `recipients.details` (object)

  - `recipients.details.pagerduty_severity` (string)
    When using a Recipient of , the severity of the alert can be specified.
    Enum: "critical", "error", "warning", "info"

  - `recipients.details.variables` (array)
    When using a Recipient of , the alert-level variables can be specified.

  - `recipients.type` (string)
    One of the allowed Recipient types.
Deprecated: Use the Recipients API first, then pass the Recipient ID.
    Enum: "pagerduty", "email", "slack", "webhook", "msteams", "msteams_workflow"

  - `recipients.target` (string)
    The target of the notification. For example, the specific Slack channel or email address.
For Recipients of  or ,
this will be the Name in the UI and  in the Recipients API.
Deprecated: Use the Recipients API first, then pass the Recipient ID.

  - `evaluation_schedule_type` (string)
    The schedule type used by the trigger. The default is frequency, where the trigger runs at the
specified frequency. The window type means that the trigger will run at the specified frequency,
but only in the time window specified in the evaluation_schedule field.
    Enum: "frequency", "window"

  - `evaluation_schedule` (object)
    A schedule that determines when the trigger is run. When the time is within the scheduled
window, the trigger will be run at the specified frequency. Outside of the window, the trigger
will not be run.

  - `evaluation_schedule.window` (object, required)
    Window start/end times and days of the week are calculated in UTC. If the end time is the same as or earlier than the start time, the end time is treated as being in the following day.

  - `evaluation_schedule.window.days_of_week` (array, required)
    Enum: "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"

  - `evaluation_schedule.window.start_time` (string, required)
    A UTC time in HH:mm format (13:00)
    Example: "14:00"

  - `evaluation_schedule.window.end_time` (string, required)
    A UTC time in HH:mm format (13:00)
    Example: "21:00"

  - `created_at` (string)

  - `updated_at` (string)

  - `baseline_details` (any)

  - `query` (object)
    A query ID or an inline query that is a strict subset of a Query Specification.

  - `query_id` (string)
    The ID of a Query that meets the criteria for being used as a Trigger, per above.

## Response 401 fields (application/json):

  - `error` (string)

## Response 404 fields (application/json):

  - `error` (string)

## Response 429 fields (application/json):

  - `error` (string)

## Response default fields (application/json):

  - `error` (string)