Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node updates an existing Role entity in the Autotask system by specifying the Role ID and the fields to update. It is useful for automating role management tasks such as changing role permissions, names, or other attributes programmatically. For example, it can be used to update a role's description or access rights in bulk or as part of a workflow that manages user roles dynamically.

Properties

Name Meaning
Role ID The unique identifier of the role to update. This is required to specify which role record will be modified.
Update Fields A resource mapper input that defines which fields of the role should be updated and their new values. This allows flexible and dynamic updates of role properties.

Output

JSON

  • id - The unique identifier of the updated role.
  • name - The name of the role after update.
  • description - The description of the role after update.
  • permissions - The permissions or access rights assigned to the role after update.
  • updatedAt - Timestamp indicating when the role was last updated.

Dependencies

  • Requires an API key credential for authenticating with the Autotask REST API.

Troubleshooting

  • If the Role ID is invalid or does not exist, the node will throw an error indicating the role could not be found. Verify the Role ID is correct.
  • If required update fields are missing or invalid, the API may reject the request. Ensure all mandatory fields for update are provided and valid.
  • Authentication errors may occur if the API key credential is missing or expired. Check the credential configuration and renew if necessary.
  • Network or API downtime can cause request failures. Retry after some time or check the Autotask service status.

Links

Discussion