Autotask icon

Autotask

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

Actions524

Contract Role Costs → Get Many

AI-generated

Overview

This node operation retrieves multiple records of Contract Role Costs from the Autotask PSA system. It is useful for scenarios where users need to fetch a list of contract role cost entries, such as for reporting, auditing, or integration with other systems. For example, a user might want to get all contract role costs associated with a specific contract or within a certain date range.

Use Case Examples

  1. Fetch all contract role costs for a given contract to analyze cost distribution.
  2. Retrieve a limited number of contract role cost records for display in a dashboard.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit.
Max Records Maximum number of contract role cost records to return when not returning all. Range is 1 to 500.
Add Picklist Labels Whether to automatically add human-readable labels for picklist fields in the output.
Add Reference Labels Whether to automatically add human-readable labels for reference fields in the output.
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 instead of nested in the userDefinedFields array.

Output

JSON

  • id - Unique identifier of the contract role cost record.
  • contractId - Identifier of the associated contract.
  • roleId - Identifier of the role associated with the cost.
  • cost - Cost value assigned to the role in the contract.
  • effectiveDate - Date from which the cost is effective.
  • expirationDate - Date until which the cost is valid.
  • userDefinedFields - Array of user-defined fields related to the contract role cost, if not flattened.
  • picklistLabels - Human-readable labels for picklist fields, if enabled.
  • referenceLabels - Human-readable labels for reference fields, if enabled.

Dependencies

  • An API key credential for Autotask PSA REST API authentication.

Troubleshooting

  • Common issues include authentication failures due to invalid or missing API credentials. Ensure the API key credential is correctly configured.
  • Errors may occur if the resource or operation parameters are incorrect or unsupported. Verify that 'Contract Role Costs' resource and 'Get Many' operation are selected.
  • If the maximum records limit is set too high, the API may throttle or reject the request. Use the 'Get All' option carefully or set a reasonable limit.
  • If user-defined fields are not appearing as expected, check the 'Flatten User-Defined Fields' option to control their structure in the output.

Links

Discussion