Actions99
- InterACT Actions
- Notification Actions
- Organization Actions
- Task Actions
- Policy Actions
- Repository Actions
- Setting Actions
- Triage Rule Actions
- User Actions
- Acquisition Actions
- API Token Actions
- Asset Actions
- Auto Asset Tag Actions
- Baseline Actions
- Case Actions
- Evidence Actions
Overview
This node integrates with Binalyze AIR to manage various resources, including tasks. Specifically, the Cancel Task operation allows users to cancel an ongoing or scheduled task by providing its unique Task ID. This is useful in scenarios where a task needs to be stopped before completion, such as halting a forensic acquisition or investigation process that is no longer required or was started by mistake.
Practical examples:
- Canceling a remote acquisition task on an endpoint device if the target machine is offline or no longer relevant.
- Stopping a triage or evidence collection task that was triggered erroneously.
- Managing task workflows dynamically by programmatically cancelling tasks based on external conditions or user input.
Properties
| Name | Meaning |
|---|---|
| Task ID | The unique identifier of the task to cancel. This must be provided to specify which task to stop. |
Output
The node outputs JSON data representing the result of the cancel task operation. Typically, this includes confirmation that the task was successfully cancelled or details about the cancellation status. The exact structure depends on the API response but generally contains fields indicating success or failure and any relevant metadata about the task state after cancellation.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Binalyze AIR API.
- Needs an API authentication token credential configured in n8n to authorize requests.
- The node depends on the Binalyze AIR service being accessible and the specified Task ID existing and being cancellable.
Troubleshooting
Common issues:
- Providing an invalid or non-existent Task ID will cause the operation to fail.
- Network connectivity problems or incorrect API credentials can prevent successful communication with the Binalyze AIR service.
- Attempting to cancel a task that is already completed or cancelled may return an error or a no-op response.
Error messages and resolutions:
- "Unknown resource" — indicates the resource parameter is incorrect; ensure "tasks" is selected.
- "Task not found" or similar — verify the Task ID is correct and the task exists.
- Authentication errors — check that the API key credential is valid and has sufficient permissions.
- Network errors — confirm network access to the Binalyze AIR API endpoint.
Links and References
- Binalyze AIR Official Documentation
- Binalyze AIR API Reference
- n8n Documentation on Creating Custom Nodes