# Update checklist item

### 🎯 **What does this operation do?**

This operation allows updating an existing item within a task's checklist, enabling:

✅ Modify the checklist item's name.\
✅ Change the item's status (done or pending).\
✅ Reorder the item's position in the checklist.

***

### 📂 **Fields and Data Types**

| **Field**         | **Data Type** | **Required?** | **Description**                                                                       |
| ----------------- | ------------- | ------------- | ------------------------------------------------------------------------------------- |
| **Workspace ID**  | `string`      | ✅ Yes         | ID of the workspace where the task is located.                                        |
| **Task ID**       | `string`      | ✅ Yes         | Identifier of the task to which the checklist belongs.                                |
| **Item ID**       | `string`      | ✅ Yes         | Identifier of the checklist item that will be updated.                                |
| **Item Name**     | `string`      | ❌ No          | Updated name of the checklist item.                                                   |
| **Status (Done)** | `boolean`     | ❌ No          | Defines whether the item has already been completed (`true`) or is pending (`false`). |
| **Order**         | `number`      | ❌ No          | Sets the new position of the item within the checklist.                               |

***

### ✅ **Step-by-step to Configure the "Update Checklist Item" Operation**

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

1. In **Hablla Studio**, open the automation flow where you want to update a checklist item.
2. Add the block **Tasks**.
3. In **right side panel**, select the operation **"Update Checklist Item"**.

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

🔹 **Workspace ID** → Set the workspace where the task is located.\
🔹 **Task ID** → Provide the identifier of the task where the item will be updated.\
🔹 **Item ID** → Enter the identifier of the checklist item that will be modified.

#### 3️⃣ **Add Additional Information (Optional)**

🔹 **Item Name** → Enter a new name for the checklist item.\
🔹 **Status (Done)** → Mark as `true` if the item is already completed or `false` if it is still pending.\
🔹 **Order** → Define the new position of the item within the checklist.

#### 4️⃣ **Save the Configuration**

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

Now, whenever this automation is triggered, the checklist item's information will be updated automatically.

***

### 📌 **Usage Example in an Automation Flow**

📊 **Scenario:** Automatically update the status of a task's checklist items when completing a flow step.

1️⃣ **Block 1** → Find the task with a pending checklist.\
2️⃣ **Block 2** → Update the corresponding item as "Done".\
3️⃣ **Block 3** → Send a notification to the responsible user.

🚀 **Result:** Whenever a flow reaches a certain step, the relevant checklist items will be updated automatically.

***

### 🎉 **Conclusion**

The operation **Update Checklist Item (update\_checklist\_item)** in the **Hablla Studio** helps keep checklists always up to date, optimizing task tracking and ensuring better organization.

If you need more support, contact our team! 🚀
