List Trigger Revisions

GET {{baseUrl}}/api/v2/triggers/:trigger_id/revisions

List the revisions associated with a trigger.

Allowed For

  • Agents

Sideloads

The following sideloads are supported:

NameWill sideload
usersThe 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.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"after_cursor":"MTUwMTYwNzUyMi4wfHwxMzQ3NTMxNjcxfA==","after_url":"https://{subdomain}.zendesk.com/api/v2/triggers/{trigger_id}/revisions.json?cursor=MTUwMTYwNzUyMi4wfHwxMzQ3NTMxNjcxfA%3D%3D\u0026limit=20","before_cursor":"fDE1MDE1NzUxMjIuMHx8MTM0NzM0MzAxMQ==","before_url":"https://{subdomain}.zendesk.com/api/v2/triggers/{trigger_id}/revisions.json?cursor=fDE1MDE1NzUxMjIuMHx8MTM0NzM0MzAxMQ%3D%3D\u0026limit=20","count":1,"trigger_revisions":[{"author_id":2,"created_at":"2016-08-15T16:04:06Z","diff":{"actions":[],"active":[],"conditions":{},"description":[],"source_id":1,"target_id":2,"title":[]},"id":100,"snapshot":{"actions":[{"field":"notification_target","value":["510312","{}"]}],"active":true,"conditions":{"all":[],"any":[{"field":"current_tags","operator":"includes","value":"fire_bulk_1"}]},"description":"Notifies requester that a comment was updated","title":"Notify requester of comment update"},"url":"https://{subdomain}.zendesk.com/api/v2/trigger/123/revisions/100.json"}]}