Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Device → Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Device resource and the Delete Undefined operation, it deletes a device identified by its ID from the Halo PSA system.

Common scenarios where this node is beneficial include automating device management tasks such as removing obsolete or undefined devices from your asset inventory in Halo PSA. For example, you might use this node in workflows that clean up device records based on certain criteria or after synchronization with other systems.

Properties

Name Meaning
Id The unique identifier (number) of the device to delete. This is a required property.

Output

The node outputs JSON data representing the response from the Halo PSA API after attempting to delete the specified device. The structure typically contains confirmation of deletion or error details if the operation failed.

No binary data output is produced by this operation.

Example output JSON might look like:

{
  "success": true,
  "message": "Device deleted successfully"
}

or in case of failure:

{
  "error": "Device not found"
}

Dependencies

  • Requires an active connection to the Halo PSA API.
  • Requires credentials including:
    • Base URL of the Halo PSA instance.
    • Tenant identifier.
    • Client ID.
    • Client Secret.
  • These credentials must be configured in n8n prior to using the node.

Troubleshooting

  • Common issues:

    • Missing or invalid credentials will cause the node to throw an error indicating no credentials were returned.
    • Providing an invalid device ID may result in an error from the API stating the device was not found.
    • Network connectivity issues can cause request failures.
  • Error messages and resolutions:

    • "No credentials returned!": Ensure that the API credentials are correctly set up in n8n.
    • "Resource Device not found" or "Operation Delete Undefined not found for resource Device": Verify that the resource and operation names are correct.
    • API errors related to authorization or permissions: Check that the client ID and secret have sufficient rights in Halo PSA.
    • JSON parsing errors: Make sure input parameters are correctly formatted and valid.

Links and References

Discussion