Autotask icon

Autotask

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

Actions524

Configuration Item Category → Get Many

AI-generated

Overview

This node operation retrieves multiple Configuration Item Categories from the Autotask PSA system. It supports fetching all records or limiting the number of records returned, with options to include human-readable labels for picklist and reference fields, select specific columns, and flatten user-defined fields for easier access. This operation is useful for scenarios where you need to list or analyze configuration item categories in bulk, such as inventory management, asset tracking, or configuration management in IT service management.

Use Case Examples

  1. Fetch all configuration item categories to synchronize with an external CMDB.
  2. Retrieve a limited number of configuration item categories for reporting or dashboard display.

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.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values.
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values.
Select Columns Names or IDs. Choose which fields to include in the response; if none selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object for easier access.

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 category, if not flattened.
    _label - Human-readable labels for picklist or reference fields, if enabled.

Dependencies

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

Troubleshooting

  • Common issues include authentication failures due to invalid or missing API credentials. Ensure the API key and username are correctly configured.
  • Errors may occur if the resource or operation parameters are incorrect or unsupported; verify that 'Configuration Item Category' resource and 'Get Many' operation are selected.
  • If no records are returned, check the filters and limits set in the node parameters.
  • Rate limiting by the Autotask API may cause temporary failures; the node attempts to initialize a rate tracker to handle this.

Links

Discussion