Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Faults → Delete One Faults

AI-generated

Overview

This node integrates with the Halo PSA API to manage "Faults" resources, specifically allowing deletion of a single fault by its ID. It is useful in scenarios where you need to programmatically remove fault records from your Halo PSA system, for example, when cleaning up resolved or invalid faults.

A practical example: You have an automated workflow that monitors fault tickets and once a fault is resolved or deemed irrelevant, this node can be used to delete that fault entry from Halo PSA automatically, keeping your fault database clean and up-to-date.

Properties

Name Meaning
Id The unique identifier (number) of the fault to delete. This is required.
Reason Optional string query parameter specifying the reason for deleting the fault.

Output

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

or in case of failure:

{
  "error": "Fault not found"
}

Dependencies

  • Requires valid credentials for the Halo PSA API, including base URL, tenant identifier, client ID, and client secret.
  • The node uses these credentials to authenticate API requests.
  • No additional external dependencies beyond the Halo PSA API and n8n's HTTP request capabilities.

Troubleshooting

  • Common issues:

    • Missing or invalid credentials will cause authentication failures.
    • Providing an invalid or non-existent fault ID will result in an error from the API.
    • Network connectivity problems may prevent successful API calls.

  • Error messages:

    • "No credentials returned!" — Ensure that the API credentials are properly configured in n8n.
    • "Resource Faults not found" or "Operation Delete One Faults not found for resource Faults" — Indicates misconfiguration of resource or operation parameters.
    • API errors such as "Fault not found" — Verify the fault ID exists before attempting deletion.

  • Resolution tips:

    • Double-check the fault ID input.
    • Confirm API credentials and permissions.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully within workflows.

Links and References

Discussion