How to Update Comments in ClickUp via API

Using the ClickUp API, you can update existing comments on tasks programmatically, making it easier to maintain accurate project discussions across your workspace.

This how-to guide walks you step by step through the official Update Comment endpoint, so you can reliably modify comment content using HTTP requests.

Understanding the ClickUp Update Comment Endpoint

The Update Comment endpoint lets you change the text of a specific comment that already exists on a task. You can use it to correct mistakes, clarify instructions, or refresh outdated information without creating a new comment.

Key details about this ClickUp endpoint:

• HTTP method: PUT
• Authentication: Personal token or OAuth 2.0 token
• Data format: JSON request body
• Scope: Task-level comments only (not list, folder, or space comments)

Prerequisites for Using the ClickUp API

Before you can update a comment through the ClickUp API, you must have a few items in place.

Required Access and Permissions in ClickUp

• An active ClickUp account with access to the workspace where the task and comment live
• Permission to view and edit the target task and its comments
• A valid API token (personal or OAuth) with the appropriate scopes

Tools You Can Use to Call the ClickUp Endpoint

You can call the Update Comment endpoint using many tools and languages, such as:

• cURL from the command line
• API clients like Postman or Insomnia
• Backend code in Node.js, Python, or other languages

If you are building a broader integration strategy around the ClickUp platform, a specialist consultancy like Consultevo can help you design scalable workflows and automation.

ClickUp Update Comment Endpoint URL

The endpoint URL uses the ID of the comment you want to update.

PUT https://api.clickup.com/api/v2/comment/{comment_id}

Replace {comment_id} with the numeric identifier of the comment you plan to modify. You can obtain this ID from previous API responses, webhooks, or by listing comments on a task.

How to Find the Comment ID in ClickUp API Responses

When you create or retrieve comments using the ClickUp API, the response body includes a field such as:

"id": "12345678"

Use that value as the {comment_id} in the Update Comment URL.

Required Headers for ClickUp Comment Updates

Your request must include specific HTTP headers so the ClickUp API can authenticate and parse your request correctly.

• Authorization: Your ClickUp API token, for example:
  Authorization: pk_your_clickup_token
• Content-Type: Set to JSON for the request body:
  Content-Type: application/json

Make sure you keep your ClickUp token secure and never expose it in client-side code, public repositories, or shared screenshots.

ClickUp Update Comment Request Body

The Update Comment endpoint accepts a JSON payload where you provide the new text for the comment.

Core Field: comment_text

The essential field in the body is:

• comment_text (string) – the updated content that will replace the existing comment text

A minimal request body looks like this:

{
  "comment_text": "Updated comment content here"
}

When the ClickUp API processes this request, it overwrites the comment message with your new content while keeping the same comment ID and associations to the task.

Step-by-Step: Updating a Comment in ClickUp

Follow these steps to update a task comment using the ClickUp API.

1. Gather the Required ClickUp Data

Before you build your request, collect:

• Your ClickUp API token
• The comment_id of the comment you need to change
• The new comment text you want to apply

2. Build the Request URL

Insert your comment_id into the base URL:

https://api.clickup.com/api/v2/comment/12345678

Use this as the target of your PUT request.

3. Add the Headers for ClickUp Authentication

Configure your request headers:

• Authorization: pk_your_clickup_token
• Content-Type: application/json

If you are using OAuth, provide the OAuth access token in the Authorization header instead of a personal token.

4. Define the JSON Body with Updated Text

Create a JSON object with the new text:

{
  "comment_text": "This is the corrected comment for the task."
}

This tells the ClickUp endpoint exactly how to change the comment.

5. Send the PUT Request to ClickUp

Use your chosen tool to send the request. In cURL, for example, a generic structure is:

curl -X PUT 
  "https://api.clickup.com/api/v2/comment/12345678" 
  -H "Authorization: pk_your_clickup_token" 
  -H "Content-Type: application/json" 
  -d '{
    "comment_text": "This is the corrected comment for the task."
  }'

Adjust the token, comment ID, and text as needed for your ClickUp environment.

6. Verify the ClickUp API Response

If the request is successful, the API returns a JSON response representing the updated comment. It typically includes fields such as:

• id – the comment ID
• comment_text – the new content you submitted
• date and date_updated – timestamps related to the comment

Confirm that the comment_text in the response matches the string you sent to the ClickUp endpoint.

Handling Errors When Updating ClickUp Comments

When working with the ClickUp Update Comment endpoint, you may encounter HTTP errors. Common causes include:

• Missing or invalid Authorization header
• Using an incorrect comment_id
• Sending a malformed JSON body
• Lack of permission to edit the comment in ClickUp

Always check the HTTP status code and the error message provided in the response. Correct the issue, then resend your request.

Best Practices for ClickUp Comment Management via API

To keep your ClickUp tasks clean and maintainable while using the API, consider these tips:

• Log all API calls that update comments, including previous and new text, for auditing.
• Validate text content in your application before sending it to ClickUp to avoid unnecessary updates.
• Use consistent formatting in your comments so team members recognize automated changes.
• Limit automated updates to comments that truly require correction or clarification.

Next Steps for Working with the ClickUp API

Once you can reliably update comments, you can combine this endpoint with others in the ClickUp API to build powerful workflows such as automated status updates, synchronization with external ticketing tools, or integrations with AI assistants.

For complete parameter definitions, response formats, and additional examples, always refer to the official ClickUp Update Comment documentation.

By following the steps in this guide and adhering to the official specification, you can confidently manage task discussions in ClickUp through code and integrate comment updates into your broader automation strategy.

Need Help With ClickUp?

If you want expert help building, automating, or scaling your ClickUp workspace, work with ConsultEvo — trusted ClickUp Solution Partners.

Get Help

“`