{"title":"Tasks API","slug":"tasks","category":"api","summary":"Quản lý tác vụ cho LLM agent — tạo, liệt kê, cập nhật, hoàn thành, xóa tác vụ với mức ưu tiên.","audience":["human","llm"],"tags":["api","tasks","todo","management"],"difficulty":"beginner","updated":"2026-06-27","word_count":200,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Tasks API\n\nTasks API cung cấp cho LLM agent cách có cấu trúc để theo dõi công việc nhiều\nbước. Tác vụ được phạm vi hóa trong mind hiện tại và tồn tại qua các phiên, do\nđó agent có thể tiếp tục công việc từ nơi đã dừng.\n\n## Các endpoint\n\n### GET /mind/tasks\n\nLiệt kê tất cả tác vụ cho mind hiện tại.\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\nPhản hồi:\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\nTạo một tác vụ mới.\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\nTạo tác vụ qua GET (cho công cụ chỉ dùng URL).\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\nCập nhật một tác vụ hiện có.\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Đánh dấu một tác vụ là đã xong.\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\nXóa vĩnh viễn một tác vụ.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/mind/task/task_001/delete\n```\n\n## Mức ưu tiên\n\n- `low` — không khẩn cấp\n- `normal` — mặc định\n- `high` — quan trọng\n- `critical` — phải làm ngay lập tức\n\n## Trạng thái\n\n- `pending` — đã tạo, chưa bắt đầu\n- `in_progress` — đang được thực hiện\n- `done` — đã hoàn thành\n- `cancelled` — đã bỏ\n\n## Mẫu: Quy trình điều khiển bởi tác vụ\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## Bước tiếp theo\n\n- [Quy trình điều khiển bởi tác vụ](/docs/llm-cookbook/task-driven-workflow)\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Tasks API

\n

Tasks API cung cấp cho LLM agent cách có cấu trúc để theo dõi công việc nhiều\nbước. Tác vụ được phạm vi hóa trong mind hiện tại và tồn tại qua các phiên, do\nđó agent có thể tiếp tục công việc từ nơi đã dừng.

\n

Các endpoint

\n

GET /mind/tasks

\n

Liệt kê tất cả tác vụ cho mind hiện tại.

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

Phản hồi:

\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

Tạo một tác vụ mới.

\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

Tạo tác vụ qua GET (cho công cụ chỉ dùng URL).

\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

Cập nhật một tác vụ hiện có.

\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

Đánh dấu một tác vụ là đã xong.

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

GET /mind/task/:id/delete

\n

Xóa vĩnh viễn một tác vụ.

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

Mức ưu tiên

\n\n

Trạng thái

\n\n

Mẫu: Quy trình điều khiển bởi tác vụ

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

Bước tiếp theo

\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"]}