Task → Find
AI-generatedOverview
This node operation allows users to find tasks within a specified ClickUp list. It supports searching tasks by exact name or custom task ID, with options to include closed tasks and subtasks. Users can also choose to list all tasks in the list without filtering by search value. This is useful for workflows that need to retrieve specific tasks or sets of tasks from ClickUp for further processing or automation.
Use Case Examples
- Find a task by its exact name in a specific ClickUp list to update or analyze it.
- Retrieve all tasks from a list including closed tasks and subtasks for reporting purposes.
- Search tasks by custom task ID to integrate with external systems referencing ClickUp tasks.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with ClickUp API, either Access Token or OAuth2. |
| List Selection | Method to select the ClickUp list to search tasks in, either by browsing hierarchy, classic hierarchy, or directly by list ID. |
| List ID | The ClickUp list ID to search tasks in, required if List Selection is 'List ID'. |
| Team (Workspace) Name or ID | The ClickUp team (workspace) to select when browsing or using hierarchy list selection. |
| Space Name or ID | The ClickUp space within the team to select when browsing or using hierarchy list selection. |
| Folder Name or ID | The ClickUp folder within the space to select when using hierarchy list selection and not folderless. |
| Folderless List | Boolean to indicate if the list is folderless when using hierarchy list selection. |
| List Name or ID | The ClickUp list to search tasks in when browsing or using hierarchy list selection. |
| Include Closed Tasks | Whether to include tasks that are in closed statuses in the search results. |
| Include Subtasks | Whether to include subtasks from the list in the search results. |
| List All Tasks | Whether to return every task in the list instead of matching a search value. |
| Find By | Criteria to find tasks by, either by exact task name or custom task ID. |
| Search Value | Exact task name or custom task ID to match. Use '*' to return all tasks. |
| Case Insensitive Match | Whether to ignore letter case when matching the search value. |
Output
JSON
id- The unique identifier of the found task.name- The name of the found task.status- The status of the found task.custom_id- The custom task ID if available.subtasks- Subtasks included if the option is enabled.closed- Indicates if the task is in a closed status.
Dependencies
- ClickUp API
Troubleshooting
- If no tasks are returned, ensure the List ID and search criteria are correct and that the list contains tasks matching the criteria.
- If using custom task ID for search, ensure the Team (Workspace) is specified when required, otherwise an error will be thrown.
- If 'List All Tasks' is disabled and no Search Value is provided, the node will throw an error prompting to enter a search value or enable listing all tasks.
- Authentication errors may occur if the API token or OAuth2 credentials are invalid or expired; verify credentials and reauthenticate if needed.