---
title: "List insight comments"
method: GET
path: "/v1/insights/{insight_id}/comments"
tags: ["InsightComments"]
deprecated: true
---

# List insight comments

`GET /v1/insights/{insight_id}/comments`

> **Deprecated.**

Get a list of comments on an insight.

Comments are returned in chronological order by default. Only published comments are included.

> 🚧 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

## Query parameters

- `page` object
  - `start_cursor` string
  - `limit` integer, nullable
- `sort` 'created_at:asc' | 'created_at:desc'

## 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
  - `page` object, required
    - `total_count` number, required — Total number of items matching the query.
    - `has_more` boolean, required — Whether there are more items beyond the current page.
    - `next_cursor` string, nullable, required — Cursor to pass as `page[start_cursor]` to fetch the next page. Null when there are no more results.
  - `thread` object, nullable, required — The comment thread status. Null if no comments have been posted on this insight.
    - `resolved` boolean, required
    - `resolved_at` string, nullable, required
    - `resolved_by` object, nullable, required
      - `id` string, required
      - `name` 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/revisions/4107f5fdf8b2/schema)