# Tasks

With it, you can create new tasks, update information, remove records, search for existing tasks, and add checklist items for better management.

### 📂 **Available Operations**

Here are the operations that can be performed with this component:

| **Operation**                                       | **Description**                            |
| --------------------------------------------------- | ------------------------------------------ |
| **Create (create)**                                 | Creates a new task in the system.          |
| **Update (update)**                                 | Updates the data of an existing task.      |
| **Delete (delete)**                                 | Removes a task from the system.            |
| **Get by ID (get\_by\_id)**                         | Gets the details of a specific task.       |
| **Get all (get\_all)**                              | Gets a list of all registered tasks.       |
| **Add checklist item (add\_checklist\_item)**       | Adds an item to the task's checklist.      |
| **Update checklist item (update\_checklist\_item)** | Updates an item in the task's checklist.   |
| **Remove checklist item (delete\_checklist\_item)** | Removes an item from the task's checklist. |

### 📑 **Variables Used in the Component**

Below are the variables used in the component **Tasks**, including their data types and whether they are required.

| **Field**            | **Data Type** | **Required?** | **Description**                                                  |
| -------------------- | ------------- | ------------- | ---------------------------------------------------------------- |
| **Workspace ID**     | `string`      | ✅ Yes         | ID of the workspace where the task is located.                   |
| **Task ID**          | `string`      | ✅ Yes         | Unique identifier of the task in the system.                     |
| **Full name**        | `string`      | ✅ Yes         | Task name.                                                       |
| **Description**      | `string`      | ✅ Yes         | Detailed description of the task.                                |
| **Responsible User** | `string`      | ✅ Yes         | Identifier of the user assigned to the task.                     |
| **Type**             | `string`      | ✅ Yes         | Defines the type of task (e.g., call, email, meeting, etc.).     |
| **Color**            | `string`      | ✅ Yes         | Defines the task color for visual organization.                  |
| **Sector**           | `string`      | ❌ No          | Department to which the task is linked.                          |
| **Person**           | `string`      | ❌ No          | Person associated with the task (if applicable).                 |
| **Organization**     | `string`      | ❌ No          | Organization linked to the task.                                 |
| **Service**          | `string`      | ❌ No          | Service related to the task (if applicable).                     |
| **Linked Card**      | `string`      | ❌ No          | ID of the card associated with the task.                         |
| **Start Date**       | `datetime`    | ✅ Yes         | Start date and time of the task.                                 |
| **Finish Date**      | `datetime`    | ✅ Yes         | Expected date and time for task completion.                      |
| **Status**           | `string`      | ✅ Yes         | Defines the task status (pending, in progress, completed, etc.). |
| **Checklist**        | `array`       | ❌ No          | List of items that make up the task's checklist.                 |

### 🎯 **How to Configure an Operation**

#### 1️⃣ **Access the Component**

1. In **Hablla Studio**, open the automation flow where you want to include the action.
2. Add the block **"Tasks"**.
3. In **right side panel**, select the desired operation.

#### 2️⃣ **Fill in the Required Fields**

Depending on the chosen operation, some fields are mandatory. Consult the variables table above to understand which data must be filled in for each operation.

#### 3️⃣ **Save the Configuration**

After filling in the fields, click the **"Save"** ✅.

Now, whenever this automation is triggered, the task will be managed according to the defined configuration.

### 📝 **Operation Details**

Each operation has required and optional fields that must be filled in as needed. Below, we will detail each of them:

1️⃣ **Create Task**\
2️⃣ **Update Task**\
3️⃣ **Delete Task**\
4️⃣ **Get Task by ID**\
5️⃣ **Get All Tasks**\
6️⃣ **Manage Task Checklist**

🚀 **Continue to the next topics to configure each operation correctly!**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/hablla-docs-en/automation-flows/all-components/hablla/tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.