Overview

This node interacts with the Habitica API to retrieve multiple tasks based on specified criteria. It supports fetching all types of tasks (daily, todo, habit, and rewards) or filtering by specific task types such as habits, dailys, todos, rewards, or completed todos. Users can apply text or notes filters with options for case sensitivity and regex matching, and can also choose to remove certain fields from the returned tasks. This node is useful for automating task management workflows, such as syncing Habitica tasks with other productivity tools or generating reports on task statuses.

Use Case Examples

1. Retrieve all types of tasks to get a comprehensive view of all user activities.
2. Fetch only habits to analyze daily habit completion rates.
3. Filter tasks by text containing a specific keyword to focus on relevant tasks.
4. Remove fields like history and reminders to simplify the task data for downstream processing.

Properties

Name	Meaning
All Types of Tasks	Whether to get all types: daily, todo, habit and rewards tasks.
Task Type	Select a specific type of task to retrieve when not fetching all types.
Filters	Filters to apply on the tasks based on text or notes content, with options for case sensitivity and regex matching.
Remove Fields	Fields to remove from the returned tasks to simplify the output.

Output

JSON

• id - Unique identifier of the task.
• type - Type of the task (habit, daily, todo, reward).
• text - Text description of the task.
• notes - Additional notes associated with the task.
• completed - Completion status of the task.
• priority - Priority level of the task.
• dueDate - Due date for the task, if applicable.
• tags - Tags associated with the task.
• checklist - Checklist items within the task.
• history - History of task completions and changes.

Dependencies

• Habitica API
• An API key credential for authentication

Troubleshooting

• Ensure the API key credential is correctly configured and has the necessary permissions to access tasks.
• If filtering by text or notes using regex, verify the regex pattern is valid to avoid errors.
• Check network connectivity and API base URL settings, especially if using a self-hosted Habitica instance.
• If certain fields are missing in the output, verify if they were removed via the 'Remove Fields' option.

Links

• Habitica API Documentation - Tasks - Official API documentation for managing tasks in Habitica.