# Add Checklist Item to Task

`POST /api/tasks/{id}/checklist`



- **Group:** Tasks
- **Since:** v0.0.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/tasks/post-task-checklist/

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authtoken` | String | **required** | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | **required** | Task unique ID. |
| `description` | String | **required** | Mandatory Checklist item description. |
| `assigned` | Number | optional | Optional Staff ID to assign this item to. |
| `list_order` | Number | optional | Optional Sort order (defaults to highest + 1). |

## Example request

```bash
curl -X POST "https://yoursite.com/api/tasks/123/checklist" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "description": "..." }'
```

## Success response

### Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "Checklist item added successfully",
  "checklist_item_id": 15
}
```

## Error responses

### Error-Response:

```json
HTTP/1.1 400 Bad Request
{
  "status": false,
  "message": "Description is required"
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/