Autotask icon

Autotask

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

Actions524

Configuration Item → Update

AI-generated

Overview

This node operation updates an existing Configuration Item in the Kaseya Autotask PSA system. It is useful for scenarios where you need to modify details of a configuration item, such as updating its attributes or metadata. For example, you might update a configuration item's status, owner, or other custom fields to reflect changes in your IT asset management or service management processes.

Use Case Examples

  1. Updating the status of a configuration item to 'In Repair'.
  2. Changing the owner or assigned resource of a configuration item.
  3. Modifying custom fields or attributes of a configuration item to keep records current.

Properties

Name Meaning
Configuration Item ID The unique identifier of the configuration item to update. This is required to specify which item to modify.
Impersonation Resource ID Optional resource ID to impersonate. Created records (configuration items, notes, attachments) will be attributed to this resource. If left blank, the credential user is used.
Proceed Without Impersonation If Denied Boolean flag indicating whether to proceed without impersonation if permission is denied when impersonation is attempted. Applies only if Impersonation Resource ID is set. If true, the request retries without impersonation and proceeds as the API user if impersonation is denied.
Fields The fields to update on the configuration item. This uses a resource mapper to define which fields and values to set during the update operation.

Output

JSON

  • id - The ID of the updated configuration item.
  • fields - The updated fields and their new values on the configuration item.
  • status - The status of the update operation, indicating success or failure.

Dependencies

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

Troubleshooting

  • Ensure the Configuration Item ID is valid and exists in the system; otherwise, the update will fail.
  • If impersonation is used, verify the impersonation resource has the necessary permissions to perform updates.
  • If 'Proceed Without Impersonation If Denied' is false and impersonation is denied, the operation will fail; consider enabling this option to fallback to API user.
  • Check that the fields to update are correctly mapped and valid for the Configuration Item resource to avoid errors.

Links

Discussion