---
title: "Update insight comment"
method: PATCH
path: "/v1/insights/{insight_id}/comments/{comment_id}"
tags: ["InsightComments"]
deprecated: true
---

# Update insight comment

`PATCH /v1/insights/{insight_id}/comments/{comment_id}`

> **Deprecated.**

Update a comment on an insight.

Only the comment author can update their own comments.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `insight_id` string, required
- `comment_id` string, required

## Request body

- object
  - `body` string, required — The updated comment content. Interpreted according to body_type (defaults to plain text).
  - `body_type` 'text' | 'html' — Format of the body field. If omitted, defaults to "text". Use "html" for rich text content.

## Response `200`

200

- object
  - `data` object, required
    - `id` string, required
    - `url` string — The URL of the doc this comment belongs to in the Dovetail web app.
    - `body` string, required
    - `author` object, required
      - `id` string, required
      - `name` string, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)