clickup-upgrade-migration

Featured

Migrate between ClickUp API versions (v2 to v3) and handle breaking changes. Use when upgrading API versions, adapting to endpoint changes, or migrating between ClickUp plan tiers. Trigger: "upgrade clickup API", "clickup v2 to v3", "clickup breaking changes", "clickup API migration", "clickup deprecation".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category