# Tasks API

Tasks API cung cấp cho LLM agent cách có cấu trúc để theo dõi công việc nhiều
bướ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
đó agent có thể tiếp tục công việc từ nơi đã dừng.

## Các endpoint

### GET /mind/tasks

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

```bash
# All tasks
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/tasks

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

Phản hồi:

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

### POST /mind/task

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

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

### GET /mind/task (query params)

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

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

### PUT /mind/task/:id

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

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

### GET /mind/task/:id/complete

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

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

### GET /mind/task/:id/delete

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

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

## Mức ưu tiên

- `low` — không khẩn cấp
- `normal` — mặc định
- `high` — quan trọng
- `critical` — phải làm ngay lập tức

## Trạng thái

- `pending` — đã tạo, chưa bắt đầu
- `in_progress` — đang được thực hiện
- `done` — đã hoàn thành
- `cancelled` — đã bỏ

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

```python
# At session start
tasks = list_tasks(status="in_progress")
if tasks:
    print(f"Resuming: {tasks[0].title}")

# Plan multi-step work
for step in plan:
    task = create_task(title=step)

# Update as you progress
update_task(task.id, status="in_progress")
# ... do work ...
update_task(task.id, status="done")
```

## Bước tiếp theo

- [Quy trình điều khiển bởi tác vụ](/docs/llm-cookbook/task-driven-workflow)
- [Cron & Scheduler](/docs/api/cron)