Autotask icon

Autotask

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

Actions524

Configuration Item → Get Many (Advanced)

AI-generated

Overview

This node operation allows users to retrieve multiple Configuration Item records from the Autotask PSA system using advanced filtering criteria. It supports fetching either all matching records or a limited number based on user input. This operation is beneficial for scenarios where users need to query Configuration Items with complex filters, such as specific attributes or conditions, and want to control the volume of data returned. For example, a user might want to get all Configuration Items related to a particular category or status using a JSON-based advanced filter.

Use Case Examples

  1. Retrieve all Configuration Items with a specific category using an advanced JSON filter.
  2. Fetch up to 100 Configuration Items that meet certain criteria defined in the advanced filter JSON.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (maxRecords).
Max Records Maximum number of Configuration Item records to return when 'Get All' is false. Range is 1 to 500.
Advanced Filter A JSON string containing a 'filter' array with Autotask API query criteria to filter Configuration Items. This allows complex querying based on field values.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values in the output.
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values in the output.
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.

Output

JSON

  • id - Unique identifier of the Configuration Item.
  • name - Name of the Configuration Item.
  • categoryId - Identifier of the category the Configuration Item belongs to.
  • status - Current status of the Configuration Item.
  • userDefinedFields - Array of user-defined fields associated with the Configuration Item, if not flattened.
  • _label fields - Additional fields with '_label' suffix providing human-readable labels for picklist and reference fields, if enabled.

Dependencies

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

Troubleshooting

  • Ensure the advanced filter JSON is correctly formatted and matches the Autotask API query criteria syntax to avoid query errors.
  • If no records are returned, verify the filter criteria and consider adjusting the 'Get All' and 'Max Records' settings.
  • Authentication errors may occur if the API key credential is invalid or expired; verify credentials in node settings.

Links

Discussion