clickup-hello-world

# ClickUp Hello World ## Overview Walk through the ClickUp hierarchy and make your first API calls. ClickUp's data model: **Workspace** (called "team" in API v2) > **Space** > **Folder** (optional) > **List** > **Task**. ## Prerequisites - Completed `clickup-install-auth` setup - Valid `CLICKUP_API_TOKEN` in environment ## ClickUp Hierarchy ``` Workspace (team_id) GET /api/v2/team └── Space (space_id) GET /api/v2/team/{team_id}/space ├── List GET /api/v2/space/{space_id}/list (folderless lists) └── Folder GET /api/v2/space/{space_id}/folder └── List GET /api/v2/folder/{folder_id}/list └── Task GET /api/v2/list/{list_id}/task ``` ## Step 1: Discover Your Workspace ```bash # Get authorized workspaces (returns team_id needed for all subsequent calls) curl -s https://api.clickup.com/api/v2/team \ -H "Authorization: $CLICKUP_API_TOKEN" | jq '.teams[] | {id, name}' ``` Response shape: ```json { "teams": [{ "id": "1234567", "name": "My Workspace", "color": "#536cfe", "members": [{ "user": { "id": 123, "username": "john", "email": "john@example.com" } }] }] } ``` ## Step 2: List Spaces ```bash TEAM_ID="1234567" curl -s "https://api.clickup.com/api/v2/team/${TEAM_ID}/space?archived=false" \ -H "Authorization: $CLICKUP_API_TOKEN" | jq '.spaces[] | {id, name}' ``` ## Step 3: Get Lists in a Space ```bash SPACE_ID="12345678" # Folderless lists (directly in Space) curl -...