Autotask icon

Autotask

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

Actions524

Contract Service → Get Many

AI-generated

Overview

This node operation retrieves multiple records of Contract Services from the Autotask PSA system. It supports fetching all records or a limited number based on user input, and can include additional options such as adding human-readable labels for picklist and reference fields, selecting specific columns, and flattening user-defined fields for easier access. This operation is useful for scenarios where users need to list or analyze multiple contract service entries, such as generating reports, syncing data with other systems, or performing bulk updates.

Use Case Examples

  1. Retrieve all contract services to generate a comprehensive report on service usage.
  2. Fetch a limited number of contract services to display in a dashboard or UI component.
  3. Get contract services with specific fields selected to optimize data transfer and processing.

Properties

Name Meaning
returnAll Whether to return all contract service records or only up to a specified limit.
maxRecords Maximum number of contract service records to return when returnAll is false. Range is 1 to 500.
addPicklistLabels Whether to automatically add human-readable "_label" fields for picklist fields in the response.
addReferenceLabels Whether to automatically add human-readable "_label" fields for reference fields in the response.
selectColumns Specify which fields (columns) to include in the response. If none are selected, all fields are returned. The ID field is always included.
flattenUdfs Whether to bring user-defined fields (UDFs) up to the top level of each object instead of nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the contract service record.
  • name - Name of the contract service.
  • description - Description of the contract service.
  • status - Status of the contract service, possibly including a human-readable label if addPicklistLabels or addReferenceLabels is enabled.
  • userDefinedFields - User-defined fields related to the contract service, either nested or flattened based on flattenUdfs setting.
  • _label - Additional human-readable labels for picklist or reference fields, appended with '_label' suffix.

Dependencies

  • An API key credential for Autotask PSA REST API

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access contract service data.
  • If the node returns no data, verify that contract services exist in the Autotask system and that any filters or limits are set appropriately.
  • Errors related to rate limits may occur; ensure the API usage complies with Autotask's rate limiting policies.

Links

  • Autotask PSA REST API Documentation - Official documentation for the Autotask PSA REST API, useful for understanding available endpoints and data structures related to contract services.

Discussion