Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

The "Update Properties" operation for the Task resource in this node allows users to modify various attributes of an existing task within the Tallyfy workflow automation platform. This includes updating the task's title, deadline, type, assignees (users, guests, groups), and other specific properties such as maximum assignable users, guest commenting permissions, and confidentiality status.

This operation is beneficial when you need to adjust task details dynamically during a workflow, for example:

  • Changing the deadline of a task due to shifting priorities.
  • Reassigning the task to different users or groups.
  • Updating the task type to reflect a change in its nature (e.g., from a regular task to an approval).
  • Restricting guest comments or marking a task as top secret for sensitive information.

Practical example: In a project management workflow, if a task's deadline needs to be extended and additional team members assigned, this operation can update those properties without creating a new task.

Properties

Name Meaning
Task ID The unique identifier of the task to update (required).
Title The new title of the task (required for update).
Deadline The new deadline date and time for the task (required for update).
Properties to Update A collection of optional properties to modify on the task:
- Task Type Change the task type; options are: Task, Approval, Expiring, Email.
- Assign Users Comma-separated list of user IDs to assign to the task.
- Assign Guests Comma-separated list of guest emails to assign to the task.
- Assign Groups Comma-separated list of group IDs to assign to the task.
- Max Assignable Maximum number of assignees allowed for the task (number).
- Prevent Guest Comment Boolean flag to prevent guests from commenting on the task.
- Top Secret Boolean flag to mark the task as top secret (confidential).

Output

The output is a JSON object representing the updated task as returned by the Tallyfy API. It contains all the current properties of the task after the update, including identifiers, titles, deadlines, assignees, and any other metadata provided by the API.

No binary data is output by this operation.

Example output structure (simplified):

{
  "id": "string",
  "title": "string",
  "deadline": "ISO8601 datetime string",
  "task_type": "task | approval | expiring | email",
  "owners": {
    "users": ["userId1", "userId2"],
    "guests": ["guestEmail1@example.com"],
    "groups": ["groupId1"]
  },
  "max_assignable": 0,
  "prevent_guest_comment": false,
  "top_secret": false,
  ...
}

Dependencies

  • Requires an active connection to the Tallyfy API via an API key credential configured in n8n.
  • The node uses the base URL https://go.tallyfy.com/api or a custom base URL if specified in credentials.
  • Requires the organization ID to construct API endpoints.
  • Proper permissions on the API key to update tasks in the specified organization.

Troubleshooting

  • Missing Required Fields: If "Task ID", "Title", or "Deadline" are not provided, the API will reject the request. Ensure these fields are set.
  • Invalid Assignee IDs or Emails: Providing invalid or non-existent user IDs, guest emails, or group IDs may cause errors or unexpected behavior. Verify assignee identifiers before use.
  • Permission Errors: Insufficient API permissions can result in authorization errors. Confirm that the API key has rights to update tasks.
  • API Rate Limits: Frequent updates might hit rate limits imposed by Tallyfy. Implement error handling and retries as needed.
  • Malformed Input: Comma-separated lists must be properly formatted without extra spaces or invalid characters.

Common error messages:

  • "Task not found": The provided Task ID does not exist.
  • "Unauthorized": API key lacks permission or is invalid.
  • "Validation failed": One or more input fields have invalid values.

Links and References

Discussion