Autotask icon

Autotask

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

Actions524

Contract Exclusion Role → Get Many

AI-generated

Overview

This node operation retrieves multiple records of Contract Exclusion Roles from the Autotask PSA system. It is useful for scenarios where you need to list or analyze contract exclusion roles in bulk, such as generating reports or syncing data with other systems. For example, a user might want to fetch all contract exclusion roles to review which roles are excluded from certain contracts.

Use Case Examples

  1. Fetch all contract exclusion roles to audit contract configurations.
  2. Retrieve a limited number of contract exclusion roles for display in a dashboard.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit (maxRecords).
Max Records Maximum number of contract exclusion role records to return when 'Get All' is false. Range is 1 to 500.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values (no labels added for empty values).
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values (no labels 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 contract exclusion role record.
  • name - Name of the contract exclusion role.
  • description - Description or details about the contract exclusion role.
  • _label - Human-readable labels for picklist or reference fields if enabled.
  • userDefinedFields - Array of user-defined fields related to the contract exclusion role, or flattened top-level fields if flattenUdfs is 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 Autotask API key and username are correctly configured.
  • Errors may occur if the resource or operation parameters are incorrect or unsupported. Verify that 'Contract Exclusion Role' resource and 'Get Many' operation are selected.
  • If the node returns no data, check that there are contract exclusion roles configured in the Autotask system and that the API user has sufficient permissions to access them.
  • Rate limiting errors may occur if too many requests are made in a short period. The node attempts to initialize a rate tracker to handle this, but if it fails, consider adding delays or reducing request frequency.

Links

Discussion