Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Ticket Category → Get Many (Advanced)

AI-generated

Overview

The node interacts with Kaseya's Autotask PSA REST API to retrieve multiple ticket category records based on advanced filtering criteria. It supports fetching all records or limiting the number of records returned, applying complex JSON-based filters, and customizing the output with options like adding human-readable labels for picklist and reference fields, selecting specific columns, and flattening user-defined fields. This operation is useful for scenarios where users need to query and analyze ticket categories with precise filtering and tailored data output, such as generating reports or integrating ticket category data into other systems.

Use Case Examples

  1. Retrieve all ticket categories that match specific criteria defined in an advanced JSON filter.
  2. Fetch a limited number of ticket categories with selected fields and include human-readable labels for easier interpretation.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (returnAll boolean). If false, the number of records returned is limited by Max Records.
Max Records Maximum number of ticket category records to return when Get All is false. Value range is 1 to 500.
Advanced Filter A JSON string containing a "filter" array with Autotask API query criteria to filter the ticket categories returned. This allows complex and precise filtering based on Autotask's API capabilities.
Add Picklist Labels Whether to automatically add "_label" fields for picklist fields with human-readable values in the output. No labels are added for empty values.
Add Reference Labels Whether to automatically add "_label" fields for reference fields with human-readable values in the output. No labels are added for empty values.
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object instead of nesting them in the userDefinedFields array, making them more accessible.

Output

JSON

  • id - Unique identifier of the ticket category record.
  • name - Name of the ticket category.
  • description - Description of the ticket category.
  • userDefinedFields - Array of user-defined fields associated with the ticket category, unless flattened.
  • _label - Additional human-readable labels for picklist or reference fields if enabled.

Dependencies

  • An API key credential for Autotask PSA REST API authentication.

Troubleshooting

  • Common issues include invalid JSON in the Advanced Filter property, which will cause API query errors. Users should validate JSON syntax and structure before use.
  • If the API credentials are incorrect or missing, authentication errors will occur. Ensure valid Autotask API credentials are configured.
  • Selecting too many records without setting limits may lead to performance issues or API rate limiting. Use the Get All and Max Records properties wisely.
  • If human-readable labels are not appearing, verify that the Add Picklist Labels and Add Reference Labels options are enabled and that the fields have corresponding label data.

Links

Discussion