Autotask icon

Autotask

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

Actions524

Configuration Item Related Item → Get Many

AI-generated

Overview

This node operation retrieves multiple Configuration Item Related Items from Kaseya's Autotask PSA REST API. It is useful for scenarios where you need to fetch a list of related items associated with configuration items, such as for asset management or IT service management workflows. For example, you can use it to get all related items linked to a specific configuration item to analyze dependencies or perform bulk updates.

Use Case Examples

  1. Fetch all related items for a given configuration item to audit asset relationships.
  2. Retrieve a limited number of related items for reporting or integration with other systems.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (maxRecords).
Max Records Maximum number of records to return when 'Get All' is false, with a range of 1 to 500.
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 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, making them accessible as top-level properties instead of nested in the userDefinedFields array.

Output

JSON

  • id - Unique identifier of the configuration item related item.
  • name - Name or title of the related item.
  • description - Description or details about the related item.
  • relatedItemId - Identifier of the related configuration item.
  • configurationItemId - Identifier of the parent configuration item.
  • userDefinedFields - Array of user-defined fields associated with the related item, if not flattened.
  • _label - Additional human-readable labels for picklist or reference fields if enabled.

Dependencies

  • An API key credential for Kaseya's Autotask PSA REST API

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access configuration item related items.
  • If the node returns no data, verify that the specified configuration item has related items.
  • Check the 'Max Records' setting if not all expected items are returned; increase or enable 'Get All' to retrieve all records.
  • If labels are not appearing as expected, verify the 'Add Picklist Labels' and 'Add Reference Labels' settings.

Links

Discussion