ClickUp Integration

与 ClickUp API 交互以进行任务管理。用于列出任务、创建任务、更新任务状态和管理工作区。基本网址：https://api.clickup.com/api/v2

# ClickUp Integration

## Credentials
**Note:** Configure your credentials in TOOLS.md or set environment variables:
- `CLICKUP_API_TOKEN` - Your ClickUp API token
- `CLICKUP_WORKSPACE_ID` - Your ClickUp workspace ID

## User Assignment Guide
When assigning tasks, use the correct email based on who should do the work:

| Email | Who | Use When |
|-------|-----|----------|
| `your-email@example.com` | **Human** | Tasks for you to do manually |
| `ai-assistant@example.com` | **AI Assistant** | Tasks for AI to execute |
| Both emails | **Both Human + AI** | Collaborative tasks where AI does research/writing, human reviews/decides |

### Examples
- **AI-only task**: "Research trend detection tools" → Assign to AI email
- **Human-only task**: "Record video for YouTube" → Assign to your email
- **Collaborative**: "Create content strategy" → Assign to both

## Common Actions

### List Tasks in a List
```http
GET https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
```

### Get All Tasks in Workspace
```http
GET https://api.clickup.com/api/v2/team/{workspace_id}/task
Authorization: {your_api_token}
```

### Create Task
```http
POST https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
Content-Type: application/json

{
  "name": "Task name",
  "description": "Task description",
  "status": "active"
}
```

### Update Task Status
```http
PUT https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
Content-Type: application/json

{
  "status": "done"
}
```

### Get Task Details
```http
GET https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
```

## Headers for All Requests
```
Authorization: {your_api_token}
Content-Type: application/json
```

## Status Values
Common statuses: `active`, `pending`, `review`, `completed`, `done`

## Error Handling
- 401: Check API token
- 404: Verify list_id or task_id exists
- 429: Rate limited - wait before retrying

---

## 中文说明

# ClickUp Integration（ClickUp 集成）

## 凭据
**注意：** 在 TOOLS.md 中配置你的凭据，或设置环境变量：
- `CLICKUP_API_TOKEN` - 你的 ClickUp API 令牌
- `CLICKUP_WORKSPACE_ID` - 你的 ClickUp 工作区 ID

## 用户分配指南
分配任务时，请根据应由谁执行工作来使用正确的电子邮件地址：

| Email | Who | Use When |
|-------|-----|----------|
| `your-email@example.com` | **Human（人类）** | 需要你手动执行的任务 |
| `ai-assistant@example.com` | **AI Assistant（AI 助手）** | 需要由 AI 执行的任务 |
| Both emails（两个邮箱） | **Both Human + AI（人类 + AI）** | 协作任务，由 AI 进行研究/撰写，人类审阅/决策 |

### 示例
- **仅 AI 的任务**："Research trend detection tools" → 分配给 AI 邮箱
- **仅人类的任务**："Record video for YouTube" → 分配给你的邮箱
- **协作任务**："Create content strategy" → 分配给两者

## 常见操作

### 列出某个列表中的任务
```http
GET https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
```

### 获取工作区中的所有任务
```http
GET https://api.clickup.com/api/v2/team/{workspace_id}/task
Authorization: {your_api_token}
```

### 创建任务
```http
POST https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
Content-Type: application/json

{
  "name": "Task name",
  "description": "Task description",
  "status": "active"
}
```

### 更新任务状态
```http
PUT https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
Content-Type: application/json

{
  "status": "done"
}
```

### 获取任务详情
```http
GET https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
```

## 所有请求的请求头
```
Authorization: {your_api_token}
Content-Type: application/json
```

## 状态值
常见状态：`active`、`pending`、`review`、`completed`、`done`

## 错误处理
- 401：检查 API 令牌
- 404：验证 list_id 或 task_id 是否存在
- 429：被限流——重试前请等待