---
title: "List Ticket Trigger Revisions"
method: GET
path: "/api/v2/triggers/{trigger_id}/revisions"
tags: ["Triggers"]
---

# List Ticket Trigger Revisions

`GET /api/v2/triggers/{trigger_id}/revisions`

List the revisions associated with a ticket trigger. Ticket trigger revision history is only available on Enterprise plans.

#### Allowed For

 * Agents

#### Sideloads

The following sideloads are supported:

| Name  | Will sideload
| ----- | -------------
| users | The user that authored each revision

#### Pagination

This endpoint uses cursor-based pagination. The records are ordered in
descending order by the `created_at` timestamp, then by `id` on duplicate
`created_at` values.

The `cursor` parameter is a non-human-readable argument you can use to move
forward or backward in time.

Each JSON response will contain the following attributes to help you get
more results:

- `after_url` requests more recent results
- `before_url` requests older results
- `after_cursor` is the cursor to build the request yourself
- `before_cursor` is the cursor to build the request yourself

The properties are null if no more records are available.

You can request a maximum of 1000 records using the `limit` parameter. If
no `limit` parameter is supplied, it will default to 1,000.

## Response `200`

Success response

- TriggerRevisionsResponse
  - `after_cursor` string
  - `after_url` string
  - `before_cursor` string
  - `before_url` string
  - `count` integer
  - `trigger_revisions` object[]
    - `author_id` integer
    - `created_at` string
    - `diff` object
      - `actions` TriggerActionDiffObject[] — An array that contain [action diff objects](#Action Diffs)
        - `field` TriggerChangeObject[] — An array of [change](#change) objects.
          - `change` string — One of `-`, `+`, `=` representing the type of change
          - `content` union — The value of the item it represents
            - boolean
            - string
            - integer
            - union[]
              - …
        - `value` TriggerChangeObject[] — An array of [change](#change) objects.
          - `change` string — One of `-`, `+`, `=` representing the type of change
          - `content` union — The value of the item it represents
            - boolean
            - string
            - integer
            - union[]
              - …
      - `active` TriggerChangeObject[] — An array of [change](#change) objects
        - `change` string — One of `-`, `+`, `=` representing the type of change
        - `content` union — The value of the item it represents
          - boolean
          - string
          - integer
          - union[]
            - union
              - …
      - `conditions` TriggerConditionDiffObject
        - `field` TriggerChangeObject[] — An array of [change](#change) objects
          - `change` string — One of `-`, `+`, `=` representing the type of change
          - `content` union — The value of the item it represents
            - boolean
            - string
            - integer
            - union[]
              - …
        - `operator` TriggerChangeObject[] — An array of [change](#change) objects
          - `change` string — One of `-`, `+`, `=` representing the type of change
          - `content` union — The value of the item it represents
            - boolean
            - string
            - integer
            - union[]
              - …
        - `value` TriggerChangeObject[] — An array of [change](#change) objects
          - `change` string — One of `-`, `+`, `=` representing the type of change
          - `content` union — The value of the item it represents
            - boolean
            - string
            - integer
            - union[]
              - …
      - `description` TriggerChangeObject[] — An array of [change](#change) objects
        - `change` string — One of `-`, `+`, `=` representing the type of change
        - `content` union — The value of the item it represents
          - boolean
          - string
          - integer
          - union[]
            - union
              - …
      - `source_id` integer — ID of the source revision
      - `target_id` integer — ID of the target revision
      - `title` TriggerChangeObject[] — An array of [change](#change) objects
        - `change` string — One of `-`, `+`, `=` representing the type of change
        - `content` union — The value of the item it represents
          - boolean
          - string
          - integer
          - union[]
            - union
              - …
    - `id` integer
    - `snapshot` TriggerSnapshotObject
      - `actions` TriggerActionObject[] — An array of [Actions](#actions) describing what the ticket trigger will do
        - `field` string
        - `value` union
          - string
          - integer
          - union[]
            - union
              - …
      - `active` boolean — Whether the ticket trigger is active
      - `conditions` TriggerConditionsObject — An object that describes the circumstances under which the trigger performs its actions. See [Conditions reference](/documentation/ticketing/reference-guides/conditions-reference)
        - `all` TriggerConditionObject[], nullable
          - `field` string
          - `operator` string
          - `value` union
            - string
            - integer
            - union[]
              - …
        - `any` TriggerConditionObject[], nullable
          - `field` string
          - `operator` string
          - `value` union
            - string
            - integer
            - union[]
              - …
      - `description` string, nullable — The description of the ticket trigger
      - `title` string — The title of the ticket trigger
    - `url` string

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)