---
title: "List personal insights"
method: GET
path: "/v1/insights/user/{user_id}"
tags: ["Insights"]
deprecated: true
---

# List personal insights

`GET /v1/insights/user/{user_id}`

> **Deprecated.**

Retrieve all insights owned by a specific user. Returns insights that were created by or assigned to the specified user.

**Note:** This endpoint is deprecated. Insights are no longer owned by individual users — they belong to the workspace. Use **List docs** (`GET /v1/docs`) instead.

Results support the same filtering, sorting, and pagination as the **List insights** endpoint.

## Path parameters

- `user_id` string, required

## 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/revisions/4107f5fdf8b2/schema)
