Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Custom Query → Delete Undefined

AI-generated

Overview

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

Common scenarios where this node is beneficial include automating the management of custom queries within Halo PSA, such as cleaning up obsolete or undefined queries programmatically without manual intervention in the Halo PSA interface.

Practical example: A user wants to automate the removal of custom queries that are no longer needed based on certain criteria evaluated elsewhere in their workflow. By providing the ID of the query to delete, this node will send the appropriate request to Halo PSA to remove it.

Properties

Name Meaning
Id The unique numeric identifier of the custom query to be deleted. This property is required.

Output

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

If an error occurs during execution and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Halo PSA API, 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.

  • The node makes HTTP requests to the Halo PSA API endpoints using these credentials.

Troubleshooting

  • No credentials returned!
    This error indicates that the node could not retrieve the necessary API credentials. Ensure that the Halo PSA API credentials are correctly set up in n8n and assigned to the node.

  • Resource or Operation not found
    If the specified resource or operation does not exist, verify that the correct resource ("Custom Query") and operation ("Delete Undefined") names are used.

  • API request errors
    Errors returned from the Halo PSA API (e.g., invalid ID, permission issues) will appear in the output JSON under the error field if "Continue On Fail" is enabled. Otherwise, they will cause the node to fail. Check the error message for details and ensure the ID is valid and the API credentials have sufficient permissions.

  • Malformed input
    Ensure the "Id" property is provided as a number and corresponds to an existing custom query.

Links and References

Discussion