Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Virtual Agent → Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Virtual Agent resource and the Delete Undefined operation, it allows users to delete a Virtual Agent entity by specifying its unique identifier.

Common scenarios where this node is beneficial include automating the management of virtual agents within the Halo PSA system, such as cleaning up unused or obsolete agents programmatically without manual intervention.

For example, you might use this node in a workflow that identifies inactive virtual agents and deletes them automatically to maintain a clean environment.

Properties

Name Meaning
Id The unique identifier of the Virtual Agent to be deleted. This is a required string input.

Output

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

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Halo PSA API.
  • The node expects configuration of the following credentials parameters:
    • Base URL of the Halo PSA API instance.
    • Tenant identifier.
    • Client ID.
    • Client Secret.

These must be set up in n8n's credentials manager before using the node.

Troubleshooting

  • Common issues:

    • Missing or invalid credentials will cause authentication failures.
    • Providing an incorrect or non-existent Virtual Agent Id will result in an error from the API indicating the resource was not found.
    • Network connectivity problems can prevent the node from reaching the Halo PSA API.

  • Error messages:

    • "No credentials returned!" — Indicates that the node could not retrieve the necessary API credentials. Ensure credentials are properly configured.
    • "Resource Virtual Agent not found" or "Operation Delete Undefined not found for resource Virtual Agent" — Suggests a misconfiguration in the resource or operation selection.
    • API errors returned in the JSON output under the error field provide details on why the deletion failed (e.g., permission denied, invalid Id).

To resolve these, verify credentials, confirm the Virtual Agent Id exists, and check network access.

Links and References

Discussion