Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves a specific Configuration Item Category from the Autotask system by its unique ID. It is useful for workflows that need to fetch detailed information about a particular configuration item category, such as for asset management, IT service management, or integration scenarios where category details are required. For example, a user can automate the retrieval of configuration item category details to update a CMDB or trigger further processing based on category attributes.

Properties

Name Meaning
Configuration Item Category ID The unique identifier of the configuration item category to retrieve. This is a required input to specify which category to get.
Add Picklist Labels Determines whether to automatically add human-readable '_label' fields for picklist fields in the response. Labels are only added if the picklist field has a value.
Add Reference Labels Determines whether to automatically add human-readable '_label' fields for reference fields in the response. Labels are only added if the reference field has a value.
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 regardless of selection.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) are brought up to the top level of the returned object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - The unique identifier of the configuration item category.
  • name - The name of the configuration item category.
  • description - Description of the configuration item category.
  • 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 - Array of user-defined fields associated with the category, unless flattened to top-level properties.

Dependencies

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

Troubleshooting

  • Error: 'Configuration Item Category ID' is missing or invalid. Ensure the ID is provided and correctly formatted.
  • If no data is returned, verify that the specified ID exists in the Autotask system.
  • Network or authentication errors may occur if the API key credential is invalid or expired. Re-authenticate or update credentials as needed.
  • Selecting specific columns that do not exist may result in incomplete data or errors. Use the 'Select Columns' option carefully.

Discussion