Overview
This node updates an existing task in TickTick, a task management application. It allows users to modify various properties of a task such as its title, content, description, dates, priority, and more. This is useful for workflows that need to programmatically adjust task details based on external triggers or data changes.
Common scenarios include:
- Automatically updating task deadlines or priorities based on project status.
- Modifying task descriptions or titles when new information becomes available.
- Adjusting scheduling details like start date, due date, or time zone dynamically.
For example, you could use this node to update the title and due date of a task when a related calendar event changes.
Properties
| Name | Meaning |
|---|---|
| JSON Parameters | Whether to provide additional fields as a raw JSON object instead of using individual input fields. |
| Project Name or ID | Select or specify the project to which the task belongs. Required to identify the context of the task. |
| Task Name or ID | The specific task to update, selected from the list or specified by ID. This is required to identify which task will be updated. |
| Task Title | The new title for the task. This is a required field when not using JSON parameters. |
| Additional Fields (JSON) | A JSON object containing any additional task properties to update, such as content, description, dates, priority, etc. Used only if "JSON Parameters" is enabled. |
| Additional Fields | A collection of optional fields to update when "JSON Parameters" is disabled: |
| - Task Content | Text content or notes associated with the task. |
| - Description of Checklist | A description or detailed notes for the checklist within the task. |
| - All Day | Boolean indicating if the task is an all-day event. |
| - Start Date | The starting date and time of the task. |
| - Due Date | The deadline or due date/time for the task. |
| - Time Zone | Time zone for the start and due dates. Options include common zones like UTC, Europe/London, Asia/Tokyo, America/New_York, etc. |
| - Priority | Task priority level. Options are High (5), Medium (3), Low (1), or None (0). |
Output
The node outputs a JSON array containing the response from the TickTick API after updating the task. This typically includes the updated task object with all its current properties reflecting the changes made.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication.
- Needs proper configuration of the TickTick API credentials in n8n.
- Depends on the TickTick API being accessible and responsive.
Troubleshooting
- Invalid JSON input: When using JSON Parameters mode, ensure the JSON string provided is valid. Errors parsing JSON will cause the node to fail with a message indicating invalid JSON.
- Missing required fields: The task ID and title (when not using JSON parameters) must be provided; otherwise, the node will throw errors.
- API request failures: Network issues, expired tokens, or insufficient permissions can cause API calls to fail. Verify credentials and network connectivity.
- Project or Task not found: If the specified project or task ID does not exist, the API will return an error. Double-check IDs or use the load options to select valid entries.