Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves a specific Configuration Item Category User-Defined Field (UDF) Association from the Autotask system by its unique ID. It is useful for users who need to fetch detailed information about how user-defined fields are associated with configuration item categories, enabling integration or automation workflows that depend on these associations. For example, it can be used to synchronize configuration item category UDF associations with other systems or to display detailed configuration metadata in a dashboard.

Properties

Name Meaning
Configuration Item Category UDF Association ID The unique identifier of the configuration item category UDF association to retrieve.
Add Picklist Labels Determines whether to automatically add human-readable "_label" fields for picklist fields in the response, enhancing readability by including label values alongside raw data.
Add Reference Labels Determines whether to automatically add human-readable "_label" fields for reference fields in the response, providing more understandable output for reference data.
Select Columns Names or IDs. Specifies which 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 If enabled, user-defined fields (UDFs) are brought to the top level of each returned object instead of being nested inside a userDefinedFields array, simplifying access to these fields.

Output

JSON

  • id - The unique identifier of the configuration item category UDF association.
  • fieldName
    • _label - Human-readable labels for picklist or reference fields if addPicklistLabels or addReferenceLabels is enabled.
  • userDefinedFields - Array of user-defined fields associated with the configuration item category, unless flattenUdfs is enabled.

Dependencies

  • Requires an authenticated connection to the Autotask REST API via an API key credential.

Troubleshooting

  • Ensure the Configuration Item Category UDF Association ID provided is valid and exists in the Autotask system; invalid IDs will cause errors.
  • If no data is returned, verify that the selected columns include fields that exist and that the user has permission to access them.
  • If labels are not appearing as expected, check that addPicklistLabels and addReferenceLabels are enabled and that the fields have non-empty values.
  • Flattening UDFs may cause naming conflicts if UDF names overlap with standard fields; disable flattenUdfs if this occurs.

Discussion