> For the complete documentation index, see [llms.txt](https://docs.amitysolutions.com/ekoai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.amitysolutions.com/ekoai/api-reference/botv2/botv2-api/task-feature/create-task.md).

# Create Task

## Task Projects API — Create Task

### Overview

Creates a new task in **Task Projects**.

* **Environment:** `https://sea-staging-h1.ekoapp.com`
* **Base path:** `/api/v1/task-projects`
* **Endpoint:** `POST /api/v1/task-projects/tasks`
* **Auth:** Bearer JWT (see “Authentication”)
* **Content type:** `application/json`
* **Idempotency:** Not specified (assumed non-idempotent)

***

### Authentication

Provide a Bearer token in the `Authorization` header.

```
Authorization: Bearer <JWT>
```

***

### Request

#### Headers

| Header          | Required | Value              |
| --------------- | -------- | ------------------ |
| `Content-Type`  | Yes      | `application/json` |
| `Authorization` | Yes      | `Bearer <JWT>`     |

#### Body (JSON)

| Field                     | Type              | Required | Description                                                                                 |
| ------------------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------- |
| `taskTitle`               | string            | Yes      | Human-readable title of the task.                                                           |
| `taskDescription`         | string            | No       | Details/notes for the task.                                                                 |
| `priority`                | integer           | No       | Priority level. Common patterns are `1`=High, `2`=Medium, `3`=Low (exact mapping may vary). |
| `dueDate`                 | string (ISO 8601) | No       | Due date/time in UTC, e.g. `2025-12-31T23:59:59Z`.                                          |
| `assigneeId`              | string            | No       | User ID to assign the task to.                                                              |
| `checklist`               | array of objects  | No       | Sub-tasks/checklist items.                                                                  |
| `checklist[].description` | string            | Yes\*    | Text for the checklist item.                                                                |
| `checklist[].isDone`      | boolean           | Yes\*    | Completion status for the checklist item.                                                   |
| `parentId`                | string            | No       | ID of the parent container (topic or parent task). Creates a subtask if set.                |

\* Required only if `checklist` is provided.

**Example request body**

```json
{
  "taskTitle": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน",
  "taskDescription": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน แสดงแนวโน้ม CSAT เทียบกับเป้าหมาย 87 เปอร์เซ็นต์ พร้อมเชิดชูพนักงานแคชเชียร์ที่ได้รับคะแนน 5 ดาวสูงสุด",
  "parentId": "6894448bf0c2250435de2e3c",
  "priority": 2,
  "assigneeId": "677e46a5e2e09e162843f948"
}
```

***

### Responses

> The exact response schema isn’t shown in your snippet. Below is a **typical** pattern for create endpoints—treat this as illustrative unless you have the server contract.

#### 201 Created

```json
{
  "id": "tsk_67a14a2de2e09e162843f955",
  "taskTitle": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน",
  "taskDescription": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน แสดงแนวโน้ม CSAT เทียบกับเป้าหมาย 87 เปอร์เซ็นต์ พร้อมเชิดชูพนักงานแคชเชียร์ที่ได้รับคะแนน 5 ดาวสูงสุด",
  "parentId": "6894448bf0c2250435de2e3c",
  "priority": 2,
  "assigneeId": "677e46a5e2e09e162843f948",
  "status": "open",
  "createdAt": "2025-08-18T06:20:00Z",
  "updatedAt": "2025-08-18T06:20:00Z"
}
```

#### Error responses (typical)

| Status                     | Meaning                  | Notes                                                  |
| -------------------------- | ------------------------ | ------------------------------------------------------ |
| `400 Bad Request`          | Invalid payload          | Missing required field, wrong types, etc.              |
| `401 Unauthorized`         | Missing/invalid token    | Check `Authorization` header.                          |
| `403 Forbidden`            | Insufficient scope/role  | Token lacks `task-projects:write` scope or equivalent. |
| `404 Not Found`            | Related resource missing | e.g., `assigneeId` not found.                          |
| `409 Conflict`             | Business rule conflict   | Duplicate, invalid state, etc.                         |
| `422 Unprocessable Entity` | Validation failed        | Field-level validation errors.                         |
| `429 Too Many Requests`    | Rate limit               | Retry after `Retry-After`.                             |
| `500/502/503`              | Server errors            | Transient; retry with backoff.                         |

**Example validation error (422)**

```json
{
  "error": "ValidationError",
  "message": "Invalid field(s)",
  "details": [
    { "path": "taskTitle", "message": "taskTitle is required" }
  ]
}
```

***

### cURL example

```bash
curl --location 'https://sea-staging-h1.ekoapp.com/api/v1/task-projects/tasks' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <REDACTED_JWT>' \
  --data '{
    "taskTitle": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน",
    "taskDescription": "ประกาศอัปเดตสถานการณ์รายสัปดาห์บนบอร์ดข่าวพนักงาน แสดงแนวโน้ม CSAT เทียบกับเป้าหมาย 87 เปอร์เซ็นต์ พร้อมเชิดชูพนักงานแคชเชียร์ที่ได้รับคะแนน 5 ดาวสูงสุด",
    "parentId": "6894448bf0c2250435de2e3c",
    "priority": 2,
    "assigneeId": "677e46a5e2e09e162843f948"
  }'
```

***

### Validation & Constraints (recommended)

| Title       | none | Yes | (max 200 characters)                                                                                 |
| ----------- | ---- | --- | ---------------------------------------------------------------------------------------------------- |
| Description | none | No  | (max 5,000 characters)                                                                               |
| Tags        | none | No  | (max 20 tags)                                                                                        |
| Tasks       | none | No  |                                                                                                      |
| Images      | none | No  | <p>Max 12 Images and Attachments</p><p>FE filter</p><ul><li>Images 6</li><li>Attachement 6</li></ul> |

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.amitysolutions.com/ekoai/api-reference/botv2/botv2-api/task-feature/create-task.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.