Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Tag ā†’ Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Tag resource and the Delete Undefined operation, it deletes a tag identified by its ID. This is useful in scenarios where you want to programmatically remove tags that are no longer needed or were created erroneously.

Practical examples include:

  • Cleaning up unused or obsolete tags in your PSA system.
  • Automating tag management as part of a larger workflow that maintains data hygiene.

Properties

Name Meaning
Id The numeric identifier of the tag to delete. This property is required.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON object contains the response from the Halo PSA API after attempting to delete the specified tag. If the deletion is successful, the response typically confirms the deletion; if there is an error, the output will contain an error message describing what went wrong.

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 the node to throw an error "No credentials returned!".
    • Providing an invalid or non-existent tag ID will result in an API error, which will be returned in the node output.
    • Network connectivity problems can cause request failures.

  • Error messages:

    • "No credentials returned!": Ensure that the API credentials are correctly configured and selected.
    • "Resource Tag not found" or "Operation Delete Undefined not found for resource Tag": Indicates misconfiguration of resource or operation parameters.
    • API errors returned from Halo PSA (e.g., tag not found) will appear in the output JSON under an error field when "Continue On Fail" is enabled.

To resolve these issues:

  • Verify credentials and their permissions.
  • Confirm the tag ID exists before attempting deletion.
  • Check network connectivity and API endpoint accessibility.

Links and References

Discussion