Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple Configuration Item Notes from the Autotask system. It is useful for scenarios where you need to fetch a list of notes associated with configuration items, such as for auditing, reporting, or integration with other systems. For example, you can use it to get all notes related to a specific configuration item or to gather recent notes for review.

Properties

Name Meaning
Fields Defines which fields of the Configuration Item Notes to retrieve and map in the output. It supports custom mapping and selection of specific fields.
Get All Determines whether to return all matching Configuration Item Notes or limit the number of results.
Max Records Specifies the maximum number of Configuration Item Notes to return when 'Get All' is false. The value can range from 1 to 500.
Add Picklist Labels If enabled, adds human-readable label fields for picklist fields in the output, making it easier to understand picklist values.
Add Reference Labels If enabled, adds human-readable label fields for reference fields in the output, improving readability of referenced data.
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 When enabled, user-defined fields (UDFs) are moved to the top level of each object instead of being nested, simplifying access to these fields.

Output

JSON

  • id - Unique identifier of the Configuration Item Note.
    fields - Values of the selected fields for each Configuration Item Note, including standard and user-defined fields._label - Human-readable labels for picklist or reference fields, if enabled.
  • userDefinedFields - Array of user-defined fields associated with the Configuration Item Note, unless flattened.

Dependencies

  • Requires an Autotask API key credential for authentication to access the Autotask REST API.

Troubleshooting

  • If no records are returned, verify that the Configuration Item Notes exist and that the query parameters (fields, filters) are correct.
  • Ensure the API credentials are valid and have sufficient permissions to read Configuration Item Notes.
  • If the node fails with a 'Resource not supported' error, confirm that the resource parameter is set to 'configurationItemNote'.
  • When selecting fields, if an invalid field name or ID is used, the API may return an error or incomplete data.
  • If the maximum records limit is exceeded, reduce the 'Max Records' value or enable 'Get All' to retrieve all records.

Discussion