Overview
This node integrates with TickTick, a task management application, to manage tasks within projects. Specifically, the "Task" resource with the "Get" operation allows users to retrieve detailed information about a specific task within a given project.
Common scenarios for this node include:
- Fetching details of a particular task to display or process further in an automation workflow.
- Retrieving task metadata such as title, description, due dates, and status for reporting or synchronization purposes.
- Using task data to trigger conditional logic or notifications based on task attributes.
For example, you might use this node to get a task's details when a new comment is added elsewhere, or to check the status of a task before updating related records in another system.
Properties
| Name | Meaning |
|---|---|
| Project Name or ID | Select the project from which to retrieve the task. You can choose from a list or specify an ID using an expression. |
| Task Name or ID | Select the specific task to retrieve within the chosen project. You can choose from a list or specify an ID using an expression. |
Output
The output is a JSON object representing the retrieved task's details. This typically includes all relevant fields provided by TickTick's API for a task, such as:
- Task ID
- Title
- Description
- Content
- Start and due dates
- Priority
- Status (e.g., completed or not)
- Time zone
- Whether it is an all-day task
- Associated project ID
No binary data is output by this operation.
Dependencies
- Requires an active connection to TickTick via OAuth2 authentication.
- The node depends on TickTick's REST API endpoints to fetch project and task data.
- Proper configuration of the OAuth2 credentials in n8n is necessary to authorize API requests.
Troubleshooting
- Invalid Project or Task ID: If the specified project or task ID does not exist or is incorrect, the API request will fail. Verify IDs are correct and accessible by the authenticated user.
- Authentication Errors: Ensure that the OAuth2 credentials are valid and have not expired. Re-authenticate if necessary.
- Empty or Missing Parameters: Both project and task identifiers are required. Omitting these will cause errors.
- API Rate Limits: Excessive requests may be throttled by TickTick. Implement retry logic or reduce request frequency if encountering rate limit errors.
- JSON Parsing Errors: Although this operation does not parse input JSON, other operations do. For those, ensure JSON inputs are well-formed.