REST API · v1

เอกสาร API

ต่อ tododee เข้ากับ CI, dashboard หรือระบบของลูกค้า ใช้ได้ในแพลน Agency สร้าง key ได้ที่ API & Export ในแอป

เริ่มต้น

ทุกคำขอส่ง key ใน header Authorization: Bearer tdk_… Base URL คือ https://tododee.com ข้อมูลเป็น JSON (UTF-8)

curl -H "Authorization: Bearer $TODODEE_KEY" https://tododee.com/v1/projects

key อ่านอย่างเดียว เรียกได้เฉพาะ GET · key อ่าน+เขียน สร้างและแก้งานได้
key ทำงานด้วยสิทธิ์ของบัญชีที่สร้าง เห็นเฉพาะโปรเจกต์ที่บัญชีนั้นเป็นสมาชิก
จำกัด 120 ครั้งต่อนาทีต่อ key ดูยอดคงเหลือใน header x-ratelimit-remaining
key แสดงครั้งเดียวตอนสร้าง ยกเลิกได้ทุกเมื่อ ระบบที่ใช้อยู่จะเรียกไม่ได้ทันที

Endpoints

GET/v1/projectsอ่าน

รายการโปรเจกต์ที่คุณเป็นสมาชิก พร้อมจำนวนงานเปิด/ทั้งหมด

GET/v1/projects/{id}อ่าน

รายละเอียดโปรเจกต์ หมวด และงานทั้งหมด · กรองด้วย ?status=todo|doing|review|done

GET/v1/projects/{id}/export?format=csv|jsonอ่าน

Export งานทั้งโปรเจกต์ (CSV มี BOM เปิดใน Excel ภาษาไทยไม่เพี้ยน)

GET/v1/todos/{id}อ่าน

งานหนึ่งงาน พร้อมงานย่อย เช็กลิสต์ คอมเมนต์ และประวัติ

GET/v1/search?q=…อ่าน

ค้นหางานข้ามโปรเจกต์ด้วยชื่อ รายละเอียด หรือรหัสเช่น CF-12

POST/v1/projects/{id}/todosเขียน

สร้างงาน

{ "title": "หน้า Login", "status": "todo", "priority": "urgent", "startOn": "2026-10-10", "dueOn": "2026-10-14", "parentId": "t_…" }

PATCH/v1/todos/{id}เขียน

แก้งาน: title, description, status, priority, startOn, dueOn, assigneeId, categoryId, parentId

{ "status": "review" }

POST/v1/todos/{id}/commentsเขียน

เพิ่มคอมเมนต์

{ "body": "deploy แล้ว" }

POST/v1/todos/{id}/checklistเขียน

เพิ่มรายการเช็กลิสต์

{ "text": "ทดสอบบนมือถือ" }

ตัวอย่าง

สร้างงานจาก CI เมื่อเทสล้ม

curl -X POST https://tododee.com/v1/projects/$PROJECT_ID/todos \
  -H "Authorization: Bearer $TODODEE_KEY" \
  -H "content-type: application/json" \
  -d '{"title":"เทสล้มบน main: '"$GITHUB_SHA"'","priority":"urgent"}'

ย้ายงานไปรอรีวิว (Node / Bun)

await fetch(`https://tododee.com/v1/todos/${id}`, {
  method: "PATCH",
  headers: { authorization: `Bearer ${process.env.TODODEE_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({ status: "review" }),
});

ดึง CSV ทุกคืน

curl -H "Authorization: Bearer $TODODEE_KEY" -o tasks.csv \
  "https://tododee.com/v1/projects/$PROJECT_ID/export?format=csv"

Error

HTTP	error	ความหมาย
401	`invalid_token`	key ผิดหรือถูกยกเลิก
402	`upgrade_required`	บัญชีไม่ได้อยู่แพลน Agency
403	`read_only_key / forbidden`	key อ่านอย่างเดียว หรือไม่มีสิทธิ์ในโปรเจกต์นั้น
404	`not_found`	ไม่พบ หรือคุณไม่ได้เป็นสมาชิก
429	`rate_limited`	เกิน 120 ครั้ง/นาที ดู header retry-after

ใช้กับ Claude Code / agent? ดู MCP server ที่ https://tododee.com/mcp ในหน้า Agents & Runner