ClickUp

ClickUp hierarchy: Team → Space → Folder → List → Task. Parent id required at each level.

Data Model

• Teams are top-level. Spaces are projects (team-scoped). Folders contain lists (space-scoped).
• Lists contain tasks. Lists can be listed by folder_id or space_id.
• Tasks are work items. Create, update, list. Task statuses are custom per list.
• Comments on tasks (task_id). Goals for tracking (team_id). Custom fields at team/list level.
• Time tracking and Tags are task/space-scoped.
• Hierarchy: team_id → space_id → folder_id → list_id → task_id.

Gotchas

• Hierarchy: Need parent id for each level. List team first, then spaces, folders, lists, tasks.
• list_id vs folder_id: Lists live in folders. list_lists accepts folder_id or space_id.
• Custom statuses: Each list can have custom statuses. List task_statuses before creating tasks.