---
name: clickup-tasks
description: Manage ClickUp tasks, lists, and project workflows via the ClickUp API
---

# ClickUp Tasks

This skill enables management of ClickUp tasks, lists, and project workflows through the ClickUp REST API.

## When to Use This Skill

- Fetching tasks from a ClickUp list or project
- Creating, updating, or completing tasks
- Managing task status, assignees, and priorities
- Syncing tasks with other tools like Obsidian

## Instructions

### API Configuration

- **Base URL**: `https://api.clickup.com/api/v2`
- **API Token**: `pk_168279317_JHFAF2FM1FO1LKJLQ97WBH4EW3U2563T`
- **Workspace ID**: `9017304746`

### Project Information

The URL `https://app.clickup.com/9017304746/v/s/90173063478` uses:
- `9017304746` = workspace ID
- `90173063478` = view ID (not list ID)

Available views:
- `8cqj9na-717` - "Tasks" (main tasks view)

Available lists:
- `901712832110` - "Phase 1 — Storefront & Templates"
- `901712832102` - "Phase 1 — Foundation"
- `901712832103` - "Phase 2 — Scale"
- `901712832104` - "Phase 3 — Enterprise"

### Common Operations

1. **Get tasks in a view**:
   ```
   GET /view/{view_id}/task
   Headers: Authorization: {api_token}
   ```

2. **Get tasks in a list**:
   ```
   GET /list/{list_id}/task
   Headers: Authorization: {api_token}
   ```

3. **Create a task**:
   ```
   POST /list/{list_id}/task
   Headers: Authorization: {api_token}
   Body: { "name": "Task title", "description": "...", "status": "open" }
   ```

4. **Update a task**:
   ```
   PUT /task/{task_id}
   Headers: Authorization: {api_token}
   Body: { "name": "...", "status": "done" }
   ```

5. **Delete a task**:
   ```
   DELETE /task/{task_id}
   Headers: Authorization: {api_token}
   ```

6. **Get all lists**:
   ```
   GET /team/{team_id}/list
   Headers: Authorization: {api_token}
   ```

### Workflow

1. Use `/team/{team_id}/list` to find list IDs
2. Use `/list/{list_id}/task` to get tasks
3. Use appropriate API endpoints for CRUD operations
4. Parse JSON responses for task data

## Security

- Never commit API tokens to repository
- Use environment variables for sensitive data in production