{"title":"Tasks API","slug":"tasks","category":"api","summary":"การจัดการ task สำหรับ LLM agent — สร้าง, รายการ, อัปเดต, ทำเสร็จ, ลบ task พร้อม priority","audience":["human","llm"],"tags":["api","tasks","todo","management"],"difficulty":"beginner","updated":"2026-06-27","word_count":111,"read_minutes":1,"llm_context":"Auth: Mind Key\nList: GET /mind/tasks?status=pending|in_progress|done|cancelled|all\nCreate: POST /mind/task { title, description?, priority?, due_at? }\nUpdate: PUT /mind/task/:id { title?, description?, priority?, status?, due_at? }\nComplete: GET /mind/task/:id/complete\nDelete: GET /mind/task/:id/delete\nPriorities: low, normal, high, critical\nStatuses: pending, in_progress, done, cancelled\nPattern: create tasks for multi-step work, update status as you progress\n","lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# Tasks API\n\nTasks API ให้ LLM agent วิธีที่มีโครงสร้างในการติดตามงานหลายขั้นตอน task อยู่ใน scope ของ mind ปัจจุบันและคงอยู่ข้าม session ทำให้ agent ทำงานต่อจากที่ค้างไว้ได้\n\n## Endpoints\n\n### GET /mind/tasks\n\nรายการ task ทั้งหมดของ mind ปัจจุบัน\n\n```bash\n# All tasks\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/tasks\n\n# Filter by status\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=pending\"\n```\n\nResponse:\n\n```json\n{\n \"tasks\": [\n {\n \"id\": \"task_001\",\n \"title\": \"Deploy v1.5.0\",\n \"description\": \"Push to production after CI green\",\n \"priority\": \"high\",\n \"status\": \"in_progress\",\n \"due_at\": \"2026-06-28T...\",\n \"created_at\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### POST /mind/task\n\nสร้าง task ใหม่\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/mind/task \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"title\": \"Update documentation\",\n \"description\": \"Add v1.5.0 changelog entries\",\n \"priority\": \"normal\",\n \"due_at\": \"2026-06-30T00:00:00Z\"\n }'\n```\n\n### GET /mind/task (query params)\n\nสร้าง task ผ่าน GET (สำหรับเครื่องมือ URL-only)\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high\"\n```\n\n### PUT /mind/task/:id\n\nอัปเดต task ที่มีอยู่\n\n```bash\ncurl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"status\": \"in_progress\",\n \"description\": \"Currently deploying, CI is green\"\n }'\n```\n\n### GET /mind/task/:id/complete\n\nทำเครื่องหมาย task ว่าเสร็จสิ้น\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/complete\n```\n\n### GET /mind/task/:id/delete\n\nลบ task อย่างถาวร\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/delete\n```\n\n## Priorities\n\n- `low` — ไม่เร่งด่วน\n- `normal` — ค่าเริ่มต้น\n- `high` — สำคัญ\n- `critical` — ต้องทำทันที\n\n## Statuses\n\n- `pending` — สร้างแล้ว ยังไม่เริ่ม\n- `in_progress` — กำลังดำเนินการ\n- `done` — เสร็จสิ้น\n- `cancelled` — ยกเลิก\n\n## รูปแบบ: Task-Driven Workflow\n\n```python\n# At session start\ntasks = list_tasks(status=\"in_progress\")\nif tasks:\n print(f\"Resuming: {tasks[0].title}\")\n\n# Plan multi-step work\nfor step in plan:\n task = create_task(title=step)\n\n# Update as you progress\nupdate_task(task.id, status=\"in_progress\")\n# ... do work ...\nupdate_task(task.id, status=\"done\")\n```\n\n## ขั้นตอนถัดไป\n\n- [Task-Driven Workflow](/docs/llm-cookbook/task-driven-workflow)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Tasks API

\n

Tasks API ให้ LLM agent วิธีที่มีโครงสร้างในการติดตามงานหลายขั้นตอน task อยู่ใน scope ของ mind ปัจจุบันและคงอยู่ข้าม session ทำให้ agent ทำงานต่อจากที่ค้างไว้ได้

\n

Endpoints

\n

GET /mind/tasks

\n

รายการ task ทั้งหมดของ mind ปัจจุบัน

\n
# All tasks\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/mind/tasks\n\n# Filter by status\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/mind/tasks?status=pending"

Response:

\n
{\n  "tasks": [\n    {\n      "id": "task_001",\n      "title": "Deploy v1.5.0",\n      "description": "Push to production after CI green",\n      "priority": "high",\n      "status": "in_progress",\n      "due_at": "2026-06-28T...",\n      "created_at": "2026-06-27T..."\n    }\n  ]\n}

POST /mind/task

\n

สร้าง task ใหม่

\n
curl -X POST https://synapse.schaefer.zone/mind/task \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "title": "Update documentation",\n    "description": "Add v1.5.0 changelog entries",\n    "priority": "normal",\n    "due_at": "2026-06-30T00:00:00Z"\n  }'

GET /mind/task (query params)

\n

สร้าง task ผ่าน GET (สำหรับเครื่องมือ URL-only)

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high"

PUT /mind/task/:id

\n

อัปเดต task ที่มีอยู่

\n
curl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "status": "in_progress",\n    "description": "Currently deploying, CI is green"\n  }'

GET /mind/task/:id/complete

\n

ทำเครื่องหมาย task ว่าเสร็จสิ้น

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/mind/task/task_001/complete

GET /mind/task/:id/delete

\n

ลบ task อย่างถาวร

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/mind/task/task_001/delete

Priorities

\n\n

Statuses

\n\n

รูปแบบ: Task-Driven Workflow

\n
# At session start\ntasks = list_tasks(status="in_progress")\nif tasks:\n    print(f"Resuming: {tasks[0].title}")\n\n# Plan multi-step work\nfor step in plan:\n    task = create_task(title=step)\n\n# Update as you progress\nupdate_task(task.id, status="in_progress")\n# ... do work ...\nupdate_task(task.id, status="done")

ขั้นตอนถัดไป

\n\n","urls":{"html":"/docs/api/tasks","text":"/docs/api/tasks?format=text","json":"/docs/api/tasks?format=json","llm":"/docs/api/tasks?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}