Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Contract → Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Contract resource with the Delete Undefined operation, it deletes a contract identified by its ID. This is useful in scenarios where you need to programmatically remove contracts from your system based on dynamic input or workflow conditions.

Practical examples include:

  • Automatically cleaning up expired or invalid contracts.
  • Removing test or placeholder contracts during data migration.
  • Deleting contracts as part of a larger automated business process.

Properties

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

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output object contains the response from the Halo PSA API after attempting to delete the specified contract. If the deletion is successful, the JSON will typically contain confirmation details from the API. In case of failure, the JSON will include an error field with the error message.

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.
    • 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 contract ID may result in an API error indicating the contract was not found.
    • Network or permission issues can cause request failures.
  • Error messages and resolutions:

    • "No credentials returned!": Ensure that the API credentials are correctly configured and selected in the node.
    • "Resource Contract not found" or "Operation Delete Undefined not found for resource Contract": Verify that the resource and operation names are correct and supported by the node version.
    • API errors returned in the output JSON under the error field: Check the contract ID validity and API permissions.

Using the node’s "Continue On Fail" option can help workflows proceed even if some deletions fail.

Links and References

  • Halo PSA API Documentation (generic link, replace with actual if available)
  • n8n documentation on HTTP Request Node for understanding API calls
  • n8n community forums for troubleshooting custom nodes and API integrations

Discussion