AvantGuard - Hudu icon

AvantGuard - Hudu

AvantGuard - Hudu

Actions109

Overview

The "Update Procedure Task" operation for the "Procedure Tasks" resource allows you to update an existing procedure task in your system. This node is useful when you need to modify details of a specific task, such as its name, description, completion status, assigned users, due date, priority, or other attributes. Common scenarios include workflow automation where tasks are updated based on external triggers (e.g., marking a task as completed after a related process finishes, reassigning tasks, or updating deadlines).

Practical Example:

  • Automatically mark a procedure task as completed when a related approval is received.
  • Change the assigned user or due date of a task based on project changes.
  • Update the priority of a task if certain conditions are met in your workflow.

Properties

Name Type Meaning
Id Number The ID of the procedure task to update. (Required)
Additional Body Fields Collection Optional fields to update on the task. Includes:
  Name String The name of the task.
  Description String A detailed description of the task.
  Completed Boolean When true, marks the task as completed.
  Procedure Id Number The ID of the procedure this task belongs to.
  Position Number The position of the task in the procedure.
  User Id Number The ID of the user assigned to the task.
  Due Date String The due date for the task.
  Priority Options The priority level of the task. Possible values: Unsure, Low, Normal, High, Urgent.
  Assigned Users JSON An array of user IDs assigned to the task.

Output

The node outputs a json object containing the updated procedure task's data as returned by the API. The structure typically includes all the fields of the task after the update, such as:

{
  "id": 123,
  "name": "Updated Task Name",
  "description": "Detailed description",
  "completed": true,
  "procedure_id": 456,
  "position": 2,
  "user_id": 789,
  "due_date": "2024-07-01",
  "priority": "high",
  "assigned_users": [101, 102]
  // ...other fields as provided by the API
}

Note: The exact output fields depend on the API response.

Dependencies

  • External Service: Requires access to the AvantGuard Hudu API.
  • API Key/Credentials: Needs valid credentials (avantguardHuduApi) with the correct base URL and permissions to update procedure tasks.
  • n8n Configuration: Ensure the credential is set up in n8n under the name avantguardHuduApi.

Troubleshooting

  • Missing or Invalid Credentials:
    Error Message: "401 Unauthorized" or similar.
    Resolution: Check that the avantguardHuduApi credential is correctly configured and has permission to update tasks.

  • Invalid Task ID:
    Error Message: "404 Not Found" or "Task not found".
    Resolution: Verify that the "Id" property matches an existing procedure task.

  • Malformed Assigned Users Field:
    Error Message: "Invalid JSON" or "assigned_users must be an array".
    Resolution: Ensure the "Assigned Users" field is a valid JSON array of user IDs.

  • Missing Required Fields:
    Error Message: "400 Bad Request" or similar.
    Resolution: Make sure the required "Id" property is provided and any additional fields conform to expected types.

Links and References

Discussion