Sync: add productivity workflow notes

wiki/entities/TodoistRestApi.md

@@ -0,0 +1,40 @@
+---
+title: "TodoistRestApi"
+type: entity
+tags: []
+last_updated: 2026-05-02
+---
+
+## Overview
+Todoist 官方 REST API v2，是 Todoist 作为 Agent 外部状态同步层的技术基础。
+
+## Base URL
+```
+https://api.todoist.com/rest/v2/
+```
+
+## Key Endpoints
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/tasks` | POST | 创建新任务 |
+| `/tasks/{task_id}` | POST | 更新任务 |
+| `/tasks/{task_id}/close` | POST | 完成任务 |
+| `/tasks/{task_id}/reopen` | POST | 重开任务 |
+| `/comments` | POST | 添加评论 |
+| `/sections` | GET/POST | 获取/创建分区 |
+
+## Authentication
+使用 Bearer Token 认证：
+```bash
+curl -s -X POST "https://api.todoist.com/rest/v2/tasks" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"content": "Task content", "project_id": "PROJECT_ID"}'
+```
+
+## Integration Context
+参见 [[TodoistTaskManager]] 中的 `todoist_api.sh` 封装脚本，以及 [[Todoist]] 实体的角色说明。
+
+## Related Entities
+- [[Todoist]]
+- [[OpenClawWorkspace]]