---
title: "Update comment"
method: PATCH
path: "/comments/{comment_id}/"
tags: ["Comments"]
---

# Update comment

`PATCH /comments/{comment_id}/`

Update a comment in a [conversation](https://dev.frontapp.com/reference/conversations).

Required scope: `comments:write`

## Path parameters

- `comment_id` string, required

## Request body

- UpdateComment
  - `body` string — Content of the comment. Can include markdown formatting. Can only be updated if the comment was created using the same token.
  - `is_pinned` boolean — Whether or not the comment is pinned in its conversation.

## Response `200`

A comment

- CommentResponse
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `conversation` string — Link to comment's conversation
      - `mentions` string — Link to comment mentions
      - `comment_replied_to` string, nullable — Link to the comment that is being replied to.
  - `id` string, required — Unique identifier of the comment
  - `author` TeammateResponse, required — A teammate is a user in Front.
    - `_links` object, required
      - `self` string — Link to resource
      - `related` object
        - `inboxes` string — Link to teammate's inboxes
        - `conversations` string — Link to teammate's conversations
        - `botSource` string — Link to the source resource of the bot (e.g. rule)
    - `id` string, required — Unique identifier of the teammate
    - `email` string, required — Email address of the teammate
    - `username` string, required — Username of the teammate (used for "@" mentions)
    - `first_name` string, required — First name of the teammate
    - `last_name` string, required — Last name of the teammate
    - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
    - `is_available` boolean, required — Whether or not the teammate is available
    - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
    - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
    - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
  - `body` string, required — Content of the comment
  - `posted_at` number — The timestamp when the comment was posted
  - `attachments` Attachment[], required — List of files attached to the comment
    - `id` string, required — The unique identifier of the attachment.
    - `filename` string, required — Name of the attached file
    - `url` string, required — URL to download the attached file
    - `content_type` string, required — Content type of the attached file in [MIME format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). Note that some attachments types may not be supported.
    - `size` integer, required — Size (in byte) of the attached file
    - `metadata` object, required — Attachment metadata
      - `is_inline` boolean — Whether or not the attachment is part of the message body
      - `cid` string — Unique identifier used to link an attachment to where it is used in the message body
  - `is_pinned` boolean, required — Whether or not the comment is pinned in its conversation

---

[API](https://skmtc.net/frontapp/apis/core-api.md) · [All operations](https://skmtc.net/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)