Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple Configuration Item Categories from the Autotask system. It is useful for scenarios where you need to fetch a list of configuration item categories for inventory, asset management, or IT service management purposes. For example, you might use it to synchronize configuration categories with another system or to generate reports based on configuration item classifications.

Properties

Name Meaning
Fields Defines which fields of the Configuration Item Categories to retrieve and map in the output. Supports custom mapping and selection of specific fields.
Get All Determines whether to return all available Configuration Item Categories or limit the number of results.
Max Records Specifies the maximum number of Configuration Item Categories to return when 'Get All' is false. The value must be between 1 and 500.
Add Picklist Labels If enabled, adds additional fields with human-readable labels for picklist fields in the output.
Add Reference Labels If enabled, adds additional fields with human-readable labels for reference fields in the output.
Select Columns Names or IDs. Allows selection of specific fields to include in the response. If none 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.

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

Dependencies

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

Troubleshooting

  • If no results are returned, verify that the API credentials are correct and have sufficient permissions.
  • Ensure that the 'Max Records' value is within the allowed range (1-500) when 'Get All' is false.
  • If custom fields are not appearing, check that the 'Fields' mapping includes those fields and that 'Flatten User-Defined Fields' is set appropriately.
  • Network or API errors may occur if the Autotask service is unreachable or if rate limits are exceeded.

Discussion