Autotask icon

Autotask

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

Actions524

Configuration Item Category → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple Configuration Item Categories from the Autotask PSA system using an advanced filtering mechanism. It is useful for scenarios where users need to query and fetch a customized list of configuration item categories based on specific criteria defined in a JSON filter. For example, a user might want to get all configuration item categories that meet certain conditions such as status, type, or other attributes.

Use Case Examples

  1. Fetch all configuration item categories with a specific status using an advanced JSON filter.
  2. Retrieve a limited number of configuration item categories matching complex criteria for reporting or integration purposes.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit.
Max Records Maximum number of records to return when not returning all results (range 1-500).
Advanced Filter A JSON string containing a "filter" array with Autotask API query criteria to specify which configuration item categories to retrieve.
Add Picklist Labels Whether to automatically add "_label" fields for picklist fields with human-readable values (no labels added for empty values).
Add Reference Labels Whether to automatically add "_label" fields for reference fields with human-readable values (no labels 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 being nested in the userDefinedFields array.

Output

JSON

  • id - Unique identifier of the configuration item category.
  • name - Name of the configuration item category.
  • description - Description of the configuration item category.
  • userDefinedFields - Array of user-defined fields associated with the configuration item category, if not flattened.
    _label - Human-readable labels for picklist or reference fields, if enabled.

Dependencies

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

Troubleshooting

  • Ensure the advanced filter JSON is correctly formatted and contains a valid "filter" array as per Autotask API documentation.
  • If no results are returned, verify the filter criteria and the selected fields to ensure they match existing configuration item categories.
  • Check API credentials and permissions to confirm access to configuration item categories.
  • If the node throws errors related to rate limits, consider the API rate tracking and retry mechanisms.

Links

Discussion