Flowyteam icon

Flowyteam

Custom node for Flowyteam API
Join our community

Actions101

Overview

The node provides an integration to update a task in the Flowyteam system. It allows users to modify various attributes of an existing task such as its heading, dates, priority, and other related fields. This operation is useful for workflows that need to programmatically adjust task details based on changing project requirements, user inputs, or automated triggers.

Common scenarios:

  • Updating the due date or priority of a task when project deadlines shift.
  • Changing the assigned user or category of a task after reassignment.
  • Adding or modifying descriptive information or dependencies for better task tracking.
  • Automating task updates based on external events or status changes.

Practical example:
A project management workflow could automatically update the priority and due date of a task when a critical issue is detected, ensuring the team is alerted and the task is reprioritized accordingly.

Properties

Name Meaning
Task ID The unique identifier of the task to update (required).
Update Heading The new title or heading for the task.
User ID The identifier of the user performing the update (required).
Update Start Date The new start date for the task, formatted as MM/DD/YYYY.
Update Due Date The new due date for the task, formatted as MM/DD/YYYY.
Update Priority The new priority level for the task. Options: Low, Medium, High, Critical.
Additional Update Fields A collection of optional fields to update, including:
- Update Category ID New category ID to assign to the task.
- Update Dependent Task ID New dependent task ID indicating task dependencies.
- Update Description New detailed description of the task.
- Update Employee Access Comma-separated list of employee IDs who have access to the task.
- Update Image URL URL of an image associated with the task.
- Update Key Results ID New key results ID linked to the task.
- Update Project ID New project ID under which the task falls.
- Update Repeat Count Number of times the task should repeat.
- Update Repeat Cycles Number of cycles for repeating the task.
- Update Repeat Type Type of repetition cycle. Options: Day, Week, Month, Year.
- Update Task Boards New setting for task boards associated with the task.

Output

The node outputs JSON data representing the updated task object returned from the Flowyteam API. This typically includes all current properties of the task after the update, such as IDs, titles, dates, priority, descriptions, and any other metadata.

If the API supports it, the output may also include status messages or confirmation of the successful update.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Flowyteam API via an API key credential configured in n8n.
  • The node depends on the Flowyteam service being accessible and the API credentials having sufficient permissions to update tasks.
  • Proper date formatting (MM/DD/YYYY) must be ensured by the user or upstream nodes.

Troubleshooting

  • Common issues:

    • Invalid or missing Task ID or User ID will cause the update to fail.
    • Incorrect date formats may result in API errors or ignored date fields.
    • Insufficient permissions on the API key can lead to authorization errors.
    • Providing invalid option values (e.g., priority or repeat type) may cause validation errors.

  • Error messages and resolutions:

    • "Task not found": Verify the Task ID exists and is correct.
    • "Unauthorized" or "Forbidden": Check API credentials and permissions.
    • "Invalid date format": Ensure dates are in MM/DD/YYYY format.
    • "Validation error": Confirm all required fields are provided and options are valid.

Links and References

  • Flowyteam API Documentation (for task update endpoint) — consult the official API docs for detailed field definitions and examples.
  • n8n documentation on creating and using API credentials.
  • General best practices for date formatting and API error handling in n8n workflows.

Discussion