41 lines
1.0 KiB
Markdown
41 lines
1.0 KiB
Markdown
---
|
||
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]]
|