# ClickUp Public API v3

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

ClickUp Public API v3 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 Chat, Documents, Collaboration, Audit Logs, and Work Management. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The first-party ClickUp Public API v3 contract: 35 operations covering Chat channels and messages, Docs and pages, entity Attachments, Workspace audit logs, object ACLs, task moves and per-user time estimates. Runs alongside v2 and renames v2 "Team" to "Workspace".

## Operations (35)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v3/workspaces/{workspace_id}/chat/channels` | Retrieve Channels |
| POST | `/api/v3/workspaces/{workspace_id}/chat/channels` | Create a Channel |
| POST | `/api/v3/workspaces/{workspace_id}/chat/channels/location` | Create a Channel on a Space, Folder, or List |
| POST | `/api/v3/workspaces/{workspace_id}/chat/channels/direct_message` | Create a Direct Message |
| GET | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}` | Retrieve a Channel |
| PATCH | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}` | Update a Channel |
| DELETE | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}` | Delete a Channel |
| GET | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}/followers` | Retrieve Channel followers |
| GET | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}/members` | Retrieve Channel members |
| GET | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}/messages` | Retrieve Channel messages |
| POST | `/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}/messages` | Send a message |
| PATCH | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}` | Update a message |
| DELETE | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}` | Delete a message |
| GET | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/reactions` | Retrieve message reactions |
| POST | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/reactions` | Create a message reaction |
| DELETE | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/reactions/{reaction}` | Delete a message reaction |
| GET | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/replies` | Retrieve message replies |
| POST | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/replies` | Create a reply message |
| GET | `/api/v3/workspaces/{workspace_id}/chat/messages/{message_id}/tagged_users` | Retrieve message tagged users |
| GET | `/api/v3/workspaces/{workspace_id}/{entity_type}/{entity_id}/attachments` | Get Attachments |
| POST | `/api/v3/workspaces/{workspace_id}/{entity_type}/{entity_id}/attachments` | Create an Attachment |
| PATCH | `/api/v3/workspaces/{workspace_id}/{object_type}/{object_id}/acls` | Update privacy and access of an object or location |
| POST | `/api/v3/workspaces/{workspace_id}/auditlogs` | Create Workspace-level audit logs |
| GET | `/api/v3/workspaces/{workspace_id}/comments/types/{comment_type}/subtypes` | Get Post Subtype IDs |
| GET | `/api/v3/workspaces/{workspace_id}/docs` | Search for Docs |
| POST | `/api/v3/workspaces/{workspace_id}/docs` | Create a Doc |
| GET | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}` | Fetch a Doc |
| GET | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}/page_listing` | Fetch PageListing for a Doc |
| GET | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}/pages` | Fetch Pages belonging to a Doc |
| POST | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}/pages` | Create a Page |
| GET | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}/pages/{page_id}` | Get page |
| PUT | `/api/v3/workspaces/{workspace_id}/docs/{doc_id}/pages/{page_id}` | Edit a Page |
| PUT | `/api/v3/workspaces/{workspace_id}/tasks/{task_id}/home_list/{list_id}` | Move a task to a new List |
| PATCH | `/api/v3/workspaces/{workspace_id}/tasks/{task_id}/time_estimates_by_user` | Update task time estimates by user |
| PUT | `/api/v3/workspaces/{workspace_id}/tasks/{task_id}/time_estimates_by_user` | Replace task time estimates |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-public-api-v3-openapi.json
- **OpenAPI** — https://developer.clickup.com/openapi/ClickUp_PUBLIC_API_V3.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/overlays/clickup-public-api-v3-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

Chat, Documents, Collaboration, Audit Logs, Work Management

---

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