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

{
  "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

{
  "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)

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

---

cURL example

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	Max 12 Images and Attachments FE filter Images 6 Attachement 6

---