# ClickUp API v2

**Canonical:** https://apis.io/apis/clickup/clickup-api-v2/  
**Provider:** Clickup — https://apis.io/providers/clickup/  
**Base URL:** https://api.clickup.com/api  
**Documentation:** https://developer.clickup.com/reference

ClickUp API v2 is one of 15 APIs that [Clickup](https://apis.io/providers/clickup/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Project Management, Task, Productivity, Work Management, and Collaboration. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The complete first-party ClickUp public API v2 contract as ClickUp publishes it: 138 operations across 83 paths covering Tasks, Lists, Folders, Spaces, Workspaces, Goals, Views, Comments, Custom Fields, Checklists, Tags, Templates, Time Tracking, Guests, Users, User Groups and Webhooks.

## Operations (60 of 138)

| Method | Path | Summary |
|---|---|---|
| POST | `/v2/task/{task_id}/attachment` | Create Task Attachment |
| POST | `/v2/oauth/token` | Get Access Token |
| GET | `/v2/user` | Get Authorized User |
| GET | `/v2/team` | Get Authorized Workspaces |
| POST | `/v2/task/{task_id}/checklist` | Create Checklist |
| PUT | `/v2/checklist/{checklist_id}` | Edit Checklist |
| DELETE | `/v2/checklist/{checklist_id}` | Delete Checklist |
| POST | `/v2/checklist/{checklist_id}/checklist_item` | Create Checklist Item |
| PUT | `/v2/checklist/{checklist_id}/checklist_item/{checklist_item_id}` | Edit Checklist Item |
| DELETE | `/v2/checklist/{checklist_id}/checklist_item/{checklist_item_id}` | Delete Checklist Item |
| GET | `/v2/task/{task_id}/comment` | Get Task Comments |
| POST | `/v2/task/{task_id}/comment` | Create Task Comment |
| GET | `/v2/view/{view_id}/comment` | Get Chat View Comments |
| POST | `/v2/view/{view_id}/comment` | Create Chat View Comment |
| GET | `/v2/list/{list_id}/comment` | Get List Comments |
| POST | `/v2/list/{list_id}/comment` | Create List Comment |
| PUT | `/v2/comment/{comment_id}` | Update Comment |
| DELETE | `/v2/comment/{comment_id}` | Delete Comment |
| GET | `/v2/comment/{comment_id}/reply` | Get Threaded Comments |
| POST | `/v2/comment/{comment_id}/reply` | Create Threaded Comment |
| GET | `/v2/list/{list_id}/field` | Get List Custom Fields |
| GET | `/v2/folder/{folder_id}/field` | Get Folder Custom Fields |
| GET | `/v2/space/{space_id}/field` | Get Space Custom Fields |
| GET | `/v2/team/{team_id}/field` | Get Workspace Custom Fields |
| POST | `/v2/task/{task_id}/field/{field_id}` | Set Custom Field Value |
| DELETE | `/v2/task/{task_id}/field/{field_id}` | Remove Custom Field Value |
| POST | `/v2/task/{task_id}/dependency` | Add Dependency |
| DELETE | `/v2/task/{task_id}/dependency` | Delete Dependency |
| POST | `/v2/task/{task_id}/link/{links_to}` | Add Task Link |
| DELETE | `/v2/task/{task_id}/link/{links_to}` | Delete Task Link |
| GET | `/v2/space/{space_id}/folder` | Get Folders |
| POST | `/v2/space/{space_id}/folder` | Create Folder |
| GET | `/v2/folder/{folder_id}` | Get Folder |
| PUT | `/v2/folder/{folder_id}` | Update Folder |
| DELETE | `/v2/folder/{folder_id}` | Delete Folder |
| PUT | `/v2/folder/{folder_id}/position` | Move Folder |
| GET | `/v2/team/{team_id}/goal` | Get Goals |
| POST | `/v2/team/{team_id}/goal` | Create Goal |
| GET | `/v2/goal/{goal_id}` | Get Goal |
| PUT | `/v2/goal/{goal_id}` | Update Goal |
| DELETE | `/v2/goal/{goal_id}` | Delete Goal |
| POST | `/v2/goal/{goal_id}/key_result` | Create Key Result |
| PUT | `/v2/key_result/{key_result_id}` | Edit Key Result |
| DELETE | `/v2/key_result/{key_result_id}` | Delete Key Result |
| POST | `/v2/team/{team_id}/guest` | Invite Guest To Workspace |
| GET | `/v2/team/{team_id}/guest/{guest_id}` | Get Guest |
| PUT | `/v2/team/{team_id}/guest/{guest_id}` | Edit Guest On Workspace |
| DELETE | `/v2/team/{team_id}/guest/{guest_id}` | Remove Guest From Workspace |
| POST | `/v2/task/{task_id}/guest/{guest_id}` | Add Guest To Task |
| DELETE | `/v2/task/{task_id}/guest/{guest_id}` | Remove Guest From Task |
| POST | `/v2/list/{list_id}/guest/{guest_id}` | Add Guest To List |
| DELETE | `/v2/list/{list_id}/guest/{guest_id}` | Remove Guest From List |
| POST | `/v2/folder/{folder_id}/guest/{guest_id}` | Add Guest To Folder |
| DELETE | `/v2/folder/{folder_id}/guest/{guest_id}` | Remove Guest From Folder |
| GET | `/v2/folder/{folder_id}/list` | Get Lists |
| POST | `/v2/folder/{folder_id}/list` | Create List |
| POST | `/v2/space/{space_id}/folder_template/{template_id}` | Create Folder from template |
| GET | `/v2/space/{space_id}/list` | Get Folderless Lists |
| POST | `/v2/space/{space_id}/list` | Create Folderless List |
| GET | `/v2/list/{list_id}` | Get List |

…and 78 more operations. They are listed in full on the page.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-api-v2-reference-openapi.json
- **OpenAPI** — https://developer.clickup.com/openapi/clickup-api-v2-reference.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/overlays/clickup-api-v2-reference-overlay.yaml
- **APIReference** — https://developer.clickup.com/reference
- **Documentation** — https://developer.clickup.com/docs

## Other Clickup APIs (12)

- [clickup Authorization API](https://apis.io/apis/clickup/clickup-authorization-api/)
- [clickup Comments API](https://apis.io/apis/clickup/clickup-comments-api/)
- [clickup Custom Fields API](https://apis.io/apis/clickup/clickup-custom-fields-api/)
- [clickup Folders API](https://apis.io/apis/clickup/clickup-folders-api/)
- [clickup Goals API](https://apis.io/apis/clickup/clickup-goals-api/)
- [clickup Lists API](https://apis.io/apis/clickup/clickup-lists-api/)
- [clickup Spaces API](https://apis.io/apis/clickup/clickup-spaces-api/)
- [clickup Tasks API](https://apis.io/apis/clickup/clickup-tasks-api/)
- [clickup Teams API](https://apis.io/apis/clickup/clickup-teams-api/)
- [clickup Time Tracking API](https://apis.io/apis/clickup/clickup-time-tracking-api/)
- [clickup Views API](https://apis.io/apis/clickup/clickup-views-api/)
- [clickup Webhooks API](https://apis.io/apis/clickup/clickup-webhooks-api/)

## Tags

Project Management, Task, Productivity, Work Management, Collaboration

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/clickup/clickup-api-v2/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/clickup/.