Autotask icon

Autotask

Consume Autotask REST API

Actions389

Overview

The 'Ticket History - Get' operation retrieves detailed historical records of a specific ticket from the Autotask system. It allows users to fetch the history of changes or events related to a ticket by specifying the ticket's ID or a specific ticket history record ID. This operation is useful for tracking the lifecycle and updates of support or service tickets, enabling audit trails, and understanding ticket progression over time.

Properties

Name Meaning
Ticket History ID The unique identifier of the specific ticket history record to retrieve.
Ticket ID The unique identifier of the ticket for which the history is requested. This is the only allowed filter when retrieving multiple history records.
Add Picklist Labels Determines whether to automatically add human-readable '_label' fields for picklist fields in the response, improving readability by showing descriptive values instead of raw codes.
Add Reference Labels Determines whether to automatically add human-readable '_label' fields for reference fields in the response, providing descriptive values for referenced entities.
Select Columns Names or IDs. Allows selection of specific fields to include in the response. If no fields are selected, all fields are returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields When enabled, user-defined fields (UDFs) are brought to the top level of each object instead of being nested inside a userDefinedFields array, simplifying access to these fields.

Output

JSON

  • id - The unique identifier of the ticket history record.
  • ticketID - The ID of the ticket associated with this history record.
  • changeDate - The date and time when the change or event occurred.
  • changedBy - Identifier or name of the user who made the change.
  • fieldName - The name of the field that was changed.
  • oldValue - The previous value before the change.
  • newValue - The new value after the change.
  • picklistLabels - Optional human-readable labels for picklist fields if 'Add Picklist Labels' is enabled.
  • referenceLabels - Optional human-readable labels for reference fields if 'Add Reference Labels' is enabled.
  • userDefinedFields - Array of user-defined fields related to the ticket history, or flattened to top-level properties if 'Flatten User-Defined Fields' is enabled.

Dependencies

  • Requires an API key credential for Autotask REST API authentication.

Troubleshooting

  • If the node returns an error about missing or invalid Ticket History ID or Ticket ID, verify that the provided IDs are correct and exist in the Autotask system.
  • If no data is returned, ensure that the ticket has history records and that the correct filters are applied.
  • Errors related to permissions may indicate that the API key used does not have sufficient rights to access ticket history data.
  • If picklist or reference labels are missing despite enabling the options, check if the fields actually have associated labels in Autotask.
  • When selecting specific columns, ensure that the field names or IDs are valid; invalid selections may cause incomplete or failed responses.

Discussion