---
title: "List insights"
method: GET
path: "/v1/insights"
tags: ["Insights"]
deprecated: true
---

# List insights

`GET /v1/insights`

> **Deprecated.**

Retrieve all insights in your workspace. Insights are polished research deliverables — written reports that synthesize findings from data entries, highlights, and other sources into actionable recommendations. They can be shared with stakeholders.

**Note:** The insights resource is deprecated. New integrations should use **docs** (`/v1/docs`) instead, which provide the same functionality. Existing insight endpoints continue to work but responses include a `Deprecation` header.

Results can be filtered by folder, project, title, or creation date. They can be sorted by creation date or title and are paginated.

## Query parameters

- `page` object
  - `start_cursor` string
  - `limit` integer, nullable
- `filter` object
  - `created_at` object — Filter results based on dates. When passing in operators, the operator pairs are mutually exclusive. For example, you cannot send both `gt` and `gte` in the same request.
    - `gt` string, date-time, nullable — Great than operator
    - `gte` string, date-time, nullable — Great than or equal to operator
    - `lt` string, date-time, nullable — Less than operator
    - `lte` string, date-time, nullable — Less than or equal operator
  - `folder_id` union — Unique identifier(s) of the associated folder(s)
    - string
    - string[]
  - `project_id` union — Unique identifier(s) of the associated project(s)
    - string
    - string[]
  - `title` object — Filter results based on string value. You can either provide a `contains` operator for substring matching or an `equal_to` operator for exact matching. These options are mutually exclusive.
    - `contains` string — Substring (case-insensitive) to search for within the target string
    - `equal_to` string — Equal to operator
- `sort` union
  - 'created_at:asc' | 'created_at:desc' | 'title:asc' | 'title:desc'
  - string[]

## Response `200`

200

- object
  - `data` object[], required
    - `id` string, required
    - `url` string — The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `title` string, required
    - `type` 'insight', required
    - `created_at` string, required
    - `folder` object, nullable, required
      - `id` 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.

## 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)