Binalyze AIR icon

Binalyze AIR

Manage Binalyze AIR resources

Actions99

Overview

This node manages task-related operations within the Binalyze AIR platform. Specifically, the "Cancel Task Assignment" operation allows users to cancel an existing assignment of a task by providing the unique identifier of that task assignment.

This is useful in scenarios where a task was assigned to a user or system but needs to be revoked or stopped before completion. For example, if a task was mistakenly assigned or conditions have changed such that the task should no longer proceed, this operation cancels that assignment.

Practical examples:

  • Canceling a forensic acquisition task assigned to an endpoint when the investigation scope changes.
  • Revoking a remediation task assigned to a security analyst due to updated priorities.

Properties

Name Meaning
Task Assignment ID The unique identifier of the task assignment to cancel. This must be provided to specify which assignment to cancel.

Output

The node outputs JSON data representing the result of the cancellation request. Typically, this will include confirmation details such as the status of the cancellation and any relevant metadata returned by the API.

If the node supports binary data output (not indicated here), it would represent related files or attachments, but for this operation, the output is expected to be purely JSON confirming the cancellation.

Dependencies

  • Requires an active connection to the Binalyze AIR API via an API key credential configured in n8n.
  • The node depends on the Binalyze AIR service being accessible and the API token having sufficient permissions to manage tasks and their assignments.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Task Assignment ID will likely cause an error indicating the resource was not found.
    • Insufficient permissions on the API token may result in authorization errors.
    • Network connectivity problems can cause timeouts or failures connecting to the Binalyze AIR API.
  • Error messages and resolutions:

    • "Unknown resource" — This indicates the resource parameter is incorrect; ensure "tasks" is selected.
    • "Task assignment not found" — Verify the Task Assignment ID is correct and exists.
    • "Unauthorized" or "Forbidden" — Check that the API key credential has the necessary permissions.
    • Timeout or network errors — Confirm network access to the Binalyze AIR API endpoint.

Links and References

Discussion