TickTick icon

TickTick

Interact with TickTick tasks and projects

Task → Search

AI-generated

Overview

This node interacts with the TickTick task management service to perform a search operation on tasks. Specifically, it allows users to search for tasks across all projects, including completed and trashed tasks, by matching keywords against task titles and content. This is useful for quickly finding specific tasks based on keywords, such as searching for "groceries" to locate all related tasks.

Use Case Examples

  1. A user wants to find all tasks related to "groceries" across all their projects, including completed and trashed tasks.
  2. A user needs to limit the search results to a maximum number, for example, retrieving only the top 50 matching tasks.

Properties

Name Meaning
Authentication Specifies the authentication method to use for accessing the TickTick API. Options include Access Token (V1 API), Email/Password (V2 API), and OAuth2 (V1 API). Default is Access Token (V1 API).
Keywords The keywords to search for within task titles and content. This is a required string input that matches tasks across all projects, including completed and trashed tasks.
Limit The maximum number of search results to return. This is a number input with a minimum value of 1, defaulting to 50.

Output

JSON

  • id - The unique identifier of the task.
  • title - The title of the task.
  • content - The content or description of the task.
  • status - The current status of the task (e.g., completed, active).
  • projectId - The identifier of the project to which the task belongs.
  • dueDate - The due date of the task, if set.
  • priority - The priority level of the task.

Dependencies

  • TickTick API

Troubleshooting

  • If the node throws an error about unsupported operation, ensure that the resource is set to 'Task' and the operation to 'Search'.
  • Authentication errors may occur if the provided credentials or tokens are invalid or expired. Verify the authentication method and credentials.
  • If no tasks are returned, check that the keywords are correctly specified and that tasks matching those keywords exist in the TickTick account.
  • Limit parameter should be a positive integer; otherwise, the node may throw an error or return unexpected results.

Links

  • TickTick API Documentation - Official API documentation for TickTick, useful for understanding available endpoints and authentication methods.

Discussion