clickup-upgrade-migration

# ClickUp Upgrade & Migration ## Overview Guide for migrating between ClickUp API versions. API v2 is the current stable version (`/api/v2/`). API v3 endpoints are gradually being introduced with terminology and structural changes. ## Key v2 vs v3 Terminology Changes | Concept | API v2 Term | API v3 Term | |---------|-------------|-------------| | Workspace | Team (`team_id`) | Workspace (`workspace_id`) | | User Group | Team | Group (`group_id`) | | Get workspaces | `GET /team` | `GET /v3/workspaces` | ## Pre-Migration Assessment ```bash #!/bin/bash # Audit current ClickUp API usage echo "=== ClickUp API Usage Audit ===" # Find all API v2 calls in codebase echo "API v2 endpoints found:" grep -rn "api/v2/" src/ --include="*.ts" --include="*.js" | \ sed 's/.*api\/v2\///' | cut -d'"' -f1 | cut -d"'" -f1 | \ sort | uniq -c | sort -rn # Count unique endpoints echo "" echo "Unique endpoints:" grep -rohn "api/v2/[a-z_/]*" src/ --include="*.ts" | sort -u # Check for deprecated patterns echo "" echo "Deprecated patterns:" grep -rn "team_id\|getauthorizedteams" src/ --include="*.ts" -i || echo " None found" ``` ## Migration Strategy: Adapter Pattern ```typescript // src/clickup/adapter.ts // Abstract away API version so you can swap v2 -> v3 per-endpoint interface ClickUpAdapter { getWorkspaces(): Promise<Workspace[]>; getSpaces(workspaceId: string): Promise<Space[]>; createTask(listId: string, task: CreateTaskInput): Promise<Task>; } class ClickUpV2Adapter imp...