Autotask icon

Autotask

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

Actions524

Configuration Item Note → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple Configuration Item Notes from the Autotask PSA system using an advanced filtering mechanism. It allows users to specify complex query criteria in JSON format to filter the notes according to their needs. This operation is useful for scenarios where users need to extract a customized list of configuration item notes based on specific conditions, such as notes related to certain configuration items, date ranges, or other attributes.

Use Case Examples

  1. Extract all configuration item notes related to a specific configuration item ID using a JSON filter.
  2. Retrieve configuration item notes created within a certain date range by specifying the appropriate filter criteria.
  3. Fetch a limited number of configuration item notes with specific status or content using advanced filters.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (boolean). If false, the number of records returned is limited by 'Max Records'.
Max Records Maximum number of records to return when 'Get All' is false. Value range is 1 to 500.
Advanced Filter A JSON string containing a 'filter' array with Autotask API query criteria to specify complex filtering conditions for retrieving configuration item notes.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values. No labels are added for empty values.
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values. No labels are added for empty 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 note.
  • content - Content or text of the configuration item note.
  • createdDate - Date and time when the note was created.
  • createdBy - User or resource who created the note.
  • configurationItemId - Identifier of the related configuration item.
  • userDefinedFields - Array of user-defined fields associated with the note, if not flattened.
  • _label fields - Optional human-readable labels for picklist and reference fields if enabled in input properties.

Dependencies

  • Autotask PSA REST API
  • API authentication credentials

Troubleshooting

  • Ensure the JSON in the 'Advanced Filter' property is correctly formatted and contains a valid 'filter' array as per Autotask API documentation.
  • If no results are returned, verify the filter criteria to ensure they match existing configuration item notes.
  • Check API credentials and permissions to confirm access to configuration item notes.
  • If the node throws errors related to rate limits, consider API usage limits and retry strategies.

Links

Discussion