Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Site → Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Site resource and the Delete Undefined operation, it deletes a site identified by its unique ID. This is useful in scenarios where you need to programmatically remove obsolete or undefined site entries from your Halo PSA system.

Practical examples include:

  • Cleaning up test or placeholder sites that were created during data import.
  • Automating the removal of sites that no longer exist or are no longer relevant.
  • Managing site lifecycle as part of broader IT service management workflows.

Properties

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

Output

The node outputs JSON data representing the response from the Halo PSA API after attempting to delete the specified site. The structure typically includes 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": "Site deleted successfully"
}

or in case of failure:

{
  "error": "Site not found"
}

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 invalid or non-existent Site ID will result in an error indicating the site was not found.
    • Network connectivity problems can prevent the node from reaching the Halo PSA API.

  • Error messages:

    • "No credentials returned!" — Ensure that the API credentials are properly configured and selected in the node.
    • "Resource Site not found" or "Operation Delete Undefined not found for resource Site" — Indicates misconfiguration of resource or operation parameters.
    • API errors returned from Halo PSA (e.g., site not found) will be passed through in the output JSON under an error field.

  • Resolution tips:

    • Double-check the Site ID value to ensure it corresponds to an existing site.
    • Verify API credentials and permissions.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

Discussion