Overview

This node retrieves detailed information about a specific task from the Soar API using the task's ID. It is useful in automation workflows where you need to fetch and process task data from Soar, such as monitoring task status, extracting task details for reporting, or integrating task information into other systems.

Use Case Examples

1. Fetch task details by providing a task ID to monitor its status in a security orchestration workflow.
2. Retrieve task information to enrich incident reports with data from Soar.

Properties

Output

JSON

• success - Indicates if the API request was successful.
• taskId - The ID of the task requested.
• statusCode - HTTP status code returned by the Soar API.
• data - The detailed task information returned from the Soar API when the request is successful.
• error - Error message if the request failed.
• response - Additional response data or error details from the API if the request failed.

Dependencies

• Requires Soar API credentials including an API token and base URL.

Troubleshooting

• Common issues include invalid or expired API tokens, incorrect task IDs, or network connectivity problems.
• Error messages include HTTP status codes and detailed response data to help diagnose issues.
• If the node is set to continue on failure, it will output error details instead of stopping the workflow.