From a21084178f5d459828af959b3976cb9912bd5165 Mon Sep 17 00:00:00 2001
From: Arie Catsman <120491684+catsmanac@users.noreply.github.com>
Date: Tue, 14 Jan 2025 06:20:12 +0100
Subject: [PATCH] Add description for Habitica get_tasks action. (#35210)

* add description for habita get_tasks action

* add field descriptions

* Update source/_integrations/habitica.markdown

Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>

* Update source/_integrations/habitica.markdown

Co-authored-by: Manu <4445816+tr4nt0r@users.noreply.github.com>

---------

Co-authored-by: tr4nt0r <4445816+tr4nt0r@users.noreply.github.com>
---
 source/_integrations/habitica.markdown | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/source/_integrations/habitica.markdown b/source/_integrations/habitica.markdown
index da44e6166e9..6b23b8dd191 100644
--- a/source/_integrations/habitica.markdown
+++ b/source/_integrations/habitica.markdown
@@ -261,6 +261,19 @@ Use a transformation item from your Habitica character's inventory on a member o
 - **Seafoam**: `seafoam` (transforms into a starfish)
 - **Shiny seed** `shiny_seed` (transforms into flower)
 
+### Action `habitica.get_tasks`
+
+Fetch tasks from your Habitica account, with optional filters to narrow down the results for more precise task retrieval.
+
+| Data attribute | Optional | Description                                                                                              |
+| -------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| config_entry   | no       | Choose the Habitica character to retrieve tasks from.                                                    |
+| type           | yes      | Filter tasks by type.  Valid types: "habits", "dailies", "todos", "rewards".                                                                                     |
+| priority       | yes      | Filter tasks by difficulty. Valid values: "trivial", "easy", "medium", "hard".                                                                              |
+| task           | yes      | Select specific tasks by matching their name (or task ID).                                               |
+| tag            | yes      | Filter tasks that have one or more of the selected tags.                                                 |
+| keyword        | yes      | Filter tasks by keyword, searching across titles, notes, and checklists.                                 |
+
 ## Automations
 
 Get started with these automation examples for Habitica, each featuring ready-to-use blueprints!