NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Related Items → Delete Related Item

AI-generated

Overview

This node interacts with the NinjaOne API to manage "Related Items." Specifically, the "Delete Related Item" operation allows users to delete a related item by its ID. This is useful in scenarios where you need to programmatically remove associations or linked records within the NinjaOne platform, such as cleaning up outdated or incorrect related items.

Practical example: If you have an automated workflow that identifies obsolete related items linked to assets or tickets, this node can be used to delete those items automatically, keeping your data clean and relevant.

Properties

Name Meaning
Related Item Id The unique numeric identifier of the related item to delete

Output

The node outputs a JSON object representing the response from the NinjaOne API after attempting to delete the related item. Typically, this will include confirmation of deletion or any error messages returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 authentication credential configured in n8n.
  • The node uses the NinjaOne API endpoint for deleting related items.
  • Network connectivity to the NinjaOne API service is necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Related Item Id will likely result in an error from the API.
    • Missing or expired API credentials will cause authentication failures.
    • Network issues may prevent the request from completing.
  • Error messages:

    • Errors returned from the NinjaOne API will be passed through in the node's output if "Continue On Fail" is enabled.
    • Typical errors include "Not Found" if the Related Item Id does not exist, or "Unauthorized" if credentials are invalid.
  • Resolutions:

    • Verify the Related Item Id is correct and exists in NinjaOne.
    • Ensure the API credentials are valid and have sufficient permissions.
    • Check network connectivity and retry if transient errors occur.

Links and References

Discussion