Update Task Soar icon

Update Task Soar

Update Task in Soar

Update Task Soar

AI-generated

Overview

This node updates a task in the Soar system by sending a PUT request to the Soar API with the specified task details. It is useful for automating task updates in workflows, such as changing task status, description, priority, or attachments based on external triggers or data.

Use Case Examples

  1. Updating a task's status and description when a related incident is resolved.
  2. Changing the priority and adding attachments to a task based on new information received.

Properties

Name Meaning
Task ID The ID of the task to update, required to identify which task to modify.
Type Type of the task, used to categorize or specify the task type.
Task Name Name of the task to update, used to rename or clarify the task.
Code Code of the task, an identifier or reference code for the task.
Department Code Department code for the task, indicating the responsible department.
Case Code Case code associated with the task, linking the task to a specific case.
Username Username of the user updating the task, for audit or tracking purposes.
Catalog Priority Code Priority code for the task, indicating its urgency or importance.
SLA Code Service Level Agreement code for the task, defining expected service levels.
Description Description of the task, providing details or context about the task.
Status Status of the task, representing its current state or progress.
Attachment IDs Array of attachment IDs in JSON format, linking files or documents to the task.
Tenancy Code Tenancy code for the task, specifying the tenant or client context.

Output

JSON

  • success - Indicates if the task update was successful (true or false).
  • taskId - The ID of the task that was updated.
  • taskName - The name of the task that was updated.
  • response - The full response from the Soar API after updating the task.
  • error - Error message if the update failed.
  • statusCode - HTTP status code returned from the API if an error occurred.

Dependencies

  • Requires Soar API credentials including an API URL and token for authentication.

Troubleshooting

  • Invalid JSON format for Attachment IDs will cause a warning and default to an empty array.
  • API request failures will log detailed error information including status code and response body.
  • If the node is set to continue on fail, it will output failure details instead of stopping execution.
  • Common errors include authentication failures, invalid task IDs, or malformed request data.

Discussion