Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple Configuration Item Types from the Autotask system using an advanced filter query. It is useful for users who need to fetch Configuration Item Types based on complex criteria, such as specific attributes or conditions defined in the Autotask API query language. For example, a user can filter Configuration Item Types by category, status, or custom fields to get a tailored list for reporting or automation purposes.

Properties

Name Meaning
Get All Determines whether to return all matching Configuration Item Types or limit the results to a specified maximum number.
Max Records Specifies the maximum number of Configuration Item Types to return when 'Get All' is false. The value must be between 1 and 500.
Advanced Filter A required JSON string containing a 'filter' array that defines the query criteria according to the Autotask API. This allows complex filtering of Configuration Item Types based on various fields.
Add Picklist Labels If enabled, adds additional fields with '_label' suffix for picklist fields to provide human-readable values instead of raw codes.
Add Reference Labels If enabled, adds additional fields with '_label' suffix for reference fields to provide human-readable values.
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.
Flatten User-Defined Fields If enabled, user-defined fields (UDFs) are moved to the top level of each returned object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the Configuration Item Type.
  • name - Name of the Configuration Item Type.
  • description - Description of the Configuration Item Type.
  • categoryId - Identifier of the category this Configuration Item Type belongs to.
  • picklistField_label - Human-readable label for picklist fields if 'Add Picklist Labels' is enabled.
  • referenceField_label - Human-readable label for reference fields if 'Add Reference Labels' is enabled.
    userDefinedFields - User-defined fields nested inside userDefinedFields array or flattened to top-level if 'Flatten User-Defined Fields' is enabled.

Dependencies

  • Requires an Autotask API key credential for authentication to access the Autotask REST API.

Troubleshooting

  • Invalid JSON in 'Advanced Filter' property can cause query failures. Ensure the JSON string is correctly formatted and contains a valid 'filter' array as per Autotask API documentation.
  • Requesting too many records without 'Get All' enabled may result in incomplete data. Use 'Get All' to retrieve all matching records if needed.
  • Selecting fields that do not exist or are misspelled in 'Select Columns' may cause errors or missing data in the response.
  • If picklist or reference labels are not appearing, verify that 'Add Picklist Labels' and 'Add Reference Labels' are enabled and that the fields contain values.
  • API rate limits or authentication errors may occur if the Autotask API key is invalid or has insufficient permissions.

Links

Discussion