Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Opps → Delete One Faults

AI-generated

Overview

This node integrates with the Halo PSA API to perform operations on various resources. Specifically, for the "Opps" resource and the "Delete One Faults" operation, it deletes a single fault record identified by its ID. This is useful in scenarios where you need to programmatically remove fault entries from your opportunity records in Halo PSA, such as cleaning up outdated or incorrect fault data.

Practical examples include:

  • Automating cleanup of faults after resolution.
  • Integrating with external systems that track fault status and trigger deletions.
  • Managing fault records as part of a larger workflow involving opportunity management.

Properties

Name Meaning
Id The numeric identifier of the fault to delete. This is required to specify which fault to remove.
Reason An optional string query parameter sent with the request to specify the reason for deletion.

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 an active connection to the Halo PSA API via an API key credential.
  • The node expects credentials providing base URL, tenant identifier, client ID, and client secret for authentication.
  • Network access to the Halo PSA service endpoint is necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid credentials will cause the node to throw an error indicating no credentials were returned.
    • Providing an invalid fault ID may result in an error from the API stating the fault was not found.
    • Network connectivity problems can cause request failures.

  • Error messages:

    • "No credentials returned!": Ensure that the API key credential is configured correctly in n8n.
    • "Resource Opps not found" or "Operation Delete One Faults not found for resource Opps": Indicates misconfiguration of resource or operation parameters.
    • API errors returned in the JSON response under error field should be reviewed and handled accordingly.

  • Resolution tips:

    • Verify the fault ID exists before attempting deletion.
    • Confirm that the API credentials have sufficient permissions.
    • Use the "Reason" property to provide context for audit trails if supported by the API.

Links and References

Discussion