---
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]]