Clickup

clickup Comments API

Operations for managing comments on tasks, views, and lists.

GitHub OpenAPI

Operations 19

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/task/{task_id}/comment Read a task's comments, newest first (v2) · Get Task Comments #
Ask an LLM
“How do I get the comments on a task through the v2 endpoint?”
“Does the v2 task comment listing return only the 25 most recent comments by default?”
Tell an agent
Via v2, list comments on task {task_id}.
Using v2, get task {task_id} comments older than {start} starting at comment {start_id}.
POST /v2/task/{task_id}/comment Comment on a task (v2) · Create Task Comment #
Ask an LLM
“What's the v2 endpoint for adding a comment to a task?”
“Can a v2 task comment be assigned to a user group?”
Tell an agent
Via v2, comment {comment_text} on task {task_id}.
Using v2, add comment {comment_text} to task {task_id} and assign it to group {group_assignee}.
GET /v2/view/{view_id}/comment Read comments in a Chat view (v2) · Get Chat View Comments #
Ask an LLM
“How can I read the comments posted in a Chat view with the v2 API?”
“Can I page through older Chat view comments in v2?”
Tell an agent
Via v2, list comments in Chat view {view_id}.
Using v2, get Chat view {view_id} comments before {start} from comment {start_id}.
POST /v2/view/{view_id}/comment Post a comment in a Chat view (v2) · Create Chat View Comment #
Ask an LLM
“How do I post a comment into a Chat view with the v2 endpoint?”
“Can I notify everyone when I add a v2 Chat view comment?”
Tell an agent
Via v2, post {comment_text} in Chat view {view_id}.
Using v2, add comment {comment_text} to Chat view {view_id} and notify all.
GET /v2/list/{list_id}/comment Read the comments on a List (v2) · Get List Comments #
Ask an LLM
“What's the v2 way to see comments added to a List?”
“Can v2 List comments be fetched further back than the latest 25?”
Tell an agent
Via v2, list comments on List {list_id}.
Using v2, get List {list_id} comments older than {start} from comment {start_id}.
POST /v2/list/{list_id}/comment Comment on a List (v2) · Create List Comment #
Ask an LLM
“How do I leave a comment on a List using v2?”
“Does a v2 List comment require an assignee?”
Tell an agent
Via v2, comment {comment_text} on List {list_id} assigned to {assignee}.
Using v2, add List {list_id} comment {comment_text} for {assignee} and notify everyone.
PUT /v2/comment/{comment_id} Edit, reassign or resolve a comment (v2) · Update Comment #
Ask an LLM
“How do I replace the text of an existing comment via v2?”
“Can I resolve a comment or assign it to a group with the v2 update?”
Tell an agent
Via v2, change comment {comment_id} to {comment_text}, assigned to {assignee}, resolved {resolved}.
Using v2, assign comment {comment_id} to group {group_assignee}.
DELETE /v2/comment/{comment_id} Delete a comment (v2) · Delete Comment #
Ask an LLM
“What's the v2 endpoint for deleting a task comment?”
“Can I remove a comment by its ID through v2?”
Tell an agent destructive · confirm first
Via v2, delete comment {comment_id}.
Using the v2 endpoint, remove comment {comment_id}.
GET /v2/comment/{comment_id}/reply Read the threaded replies to a comment · Get Threaded Comments #
Ask an LLM
“How do I see the replies in a comment thread?”
“Is the parent comment included when I fetch its threaded replies?”
Tell an agent
List the threaded replies under comment {comment_id}.
Show the reply thread for comment {comment_id}.
POST /v2/comment/{comment_id}/reply Reply in a comment thread · Create Threaded Comment #
Ask an LLM
“Can I reply directly to a comment instead of adding a new one?”
“Is it possible to assign a threaded reply to someone?”
Tell an agent
Reply {comment_text} to comment {comment_id}.
Add threaded reply {comment_text} under comment {comment_id} and assign it to {assignee}.
GET /task/{task_id}/comment Read a task's comments (unversioned path) · Get task comments #
Ask an LLM
“Which non-v2 endpoint returns a task's comments with user info and timestamps?”
“Can the unversioned task comments path be paged with start and start_id?”
Tell an agent
Using the unversioned path, get comments on task {task_id}.
On the non-v2 endpoint, read task {task_id} comments from comment {start_id}.
POST /task/{task_id}/comment Comment on a task (unversioned path) · Create a task comment #
Ask an LLM
“Is there a non-v2 path for posting a task comment with mentions?”
“Does the assignee get notified when I add a task comment on the unversioned endpoint?”
Tell an agent
Using the unversioned path, comment {comment_text} on task {task_id}.
On the non-v2 endpoint, add comment {comment_text} to task {task_id} for follow-up by {assignee}.
GET /view/{view_id}/comment Read a view's comments (unversioned path) · Get view comments #
Ask an LLM
“Which non-v2 endpoint returns all comments on a view?”
“Can I read view comments from the unversioned path?”
Tell an agent
Using the unversioned path, get comments on view {view_id}.
On the non-v2 endpoint, list comments for view {view_id}.
POST /view/{view_id}/comment Comment on a view (unversioned path) · Create a view comment #
Ask an LLM
“Is there a non-v2 path for adding a comment to a view?”
“Can a view comment posted through the unversioned endpoint be assigned?”
Tell an agent
Using the unversioned path, comment {comment_text} on view {view_id}.
On the non-v2 endpoint, post {comment_text} to view {view_id} assigned to {assignee}.
GET /list/{list_id}/comment Read a List's comments (unversioned path) · Get list comments #
Ask an LLM
“Which non-v2 endpoint lists all comments on a List?”
“Can I fetch List comments from the unversioned path?”
Tell an agent
Using the unversioned path, get comments on List {list_id}.
On the non-v2 endpoint, read the comments for List {list_id}.
POST /list/{list_id}/comment Comment on a List (unversioned path) · Create a list comment #
Ask an LLM
“Is there a non-v2 path for leaving a comment on a List without an assignee?”
“Can I notify everyone when commenting on a List through the unversioned endpoint?”
Tell an agent
Using the unversioned path, comment {comment_text} on List {list_id}.
On the non-v2 endpoint, post List comment {comment_text} to {list_id} and notify all.
PUT /comment/{comment_id} Update a comment (unversioned path) · Update a comment #
Ask an LLM
“Which non-v2 endpoint lets me edit a comment's text or toggle it resolved?”
“Can I change just a comment's assignee on the unversioned path?”
Tell an agent
Using the unversioned path, update comment {comment_id} text to {comment_text}.
On the non-v2 endpoint, set comment {comment_id} resolved to {resolved}.
DELETE /comment/{comment_id} Permanently delete a comment (unversioned path) · Delete a comment #
Ask an LLM
“Is deleting a comment on the non-v2 endpoint reversible?”
“What's the unversioned path for removing a comment?”
Tell an agent destructive · confirm first
Using the unversioned path, permanently delete comment {comment_id}.
On the non-v2 endpoint, remove comment {comment_id} for good.
GET /api/v3/workspaces/{workspace_id}/comments/types/{comment_type}/subtypes Get the post subtype IDs for chat posts · Get Post Subtype IDs #
Ask an LLM
“Where do I find the IDs for Announcement, Discussion, Idea and Update post types?”
“Which subtype ID should I pass when sending a chat message as a post?”
Tell an agent
Get the post subtype IDs for comment type {comment_type} in Workspace {workspace_id}.
List the Announcement, Discussion, Idea and Update subtype IDs in Workspace {workspace_id} for type {comment_type}.

Documentation

📖
Documentation
https://developer.clickup.com/docs/tasks
📖
Documentation
https://developer.clickup.com/reference/get-spaces
📖
Documentation
https://developer.clickup.com/reference/get-lists
📖
Documentation
https://developer.clickup.com/reference/get-folders
📖
Documentation
https://developer.clickup.com/reference/get-goals
📖
Documentation
https://developer.clickup.com/reference/get-task-comments
📖
Documentation
https://developer.clickup.com/reference/get-teams
📖
Documentation
https://developer.clickup.com/docs/webhooks
📖
Documentation
https://developer.clickup.com/reference/get-accessible-custom-fields
📖
Documentation
https://developer.clickup.com/reference/get-time-entries-within-a-date-range
📖
Documentation
https://developer.clickup.com/reference/get-views
📖
Documentation
https://developer.clickup.com/docs/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-comments-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/asyncapi/clickup-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clickup-comments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickup-comments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Comments API
  version: '1.0'
  description: 'Operations tagged Comments across 3 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-comments-openapi.yml, clickup-public-api-v3-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
- url: https://api.clickup.com/
  description: ClickUp
tags:


# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-comments-api-openapi.yml