Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves a specific Contract Exclusion Set Excluded Role from the Autotask system using its unique ID. It is useful for workflows that need to fetch detailed information about roles excluded from contract exclusion sets, such as for auditing, reporting, or integration with other systems.

Properties

Name Meaning
Excluded Role ID The unique identifier of the contract exclusion set excluded role to retrieve.
Add Picklist Labels Determines whether to add human-readable label fields for picklist fields in the response.
Add Reference Labels Determines whether to add human-readable label fields for reference fields in the response.
Select Columns Names or IDs. Specifies which fields to include in the response. If none are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) are brought to the top level of the response object instead of nested inside an array.

Output

JSON

  • id - The unique identifier of the excluded role.
  • name - The name of the excluded role.
  • userDefinedFields - Array of user-defined fields associated with the excluded role, if not flattened.
    _label - Human-readable labels for picklist or reference fields, added if enabled.

Dependencies

  • Requires an API key credential for Autotask REST API authentication.

Troubleshooting

  • If the specified Excluded Role ID does not exist, the node will throw an error indicating the resource was not found. Verify the ID is correct.
  • If API authentication fails, ensure the Autotask API key credential is valid and has necessary permissions.
  • Selecting invalid or unsupported fields in 'Select Columns' may cause errors; use the dropdown or valid expressions to specify fields.

Discussion