---
title: "List Knowledge Base Entries"
method: GET
path: "/v1/projects/{projectId}/knowledge-base"
tags: ["Project Editing"]
---

# List Knowledge Base Entries

`GET /v1/projects/{projectId}/knowledge-base`

Get all knowledge base entries for a project. Requires email:read permission.

## Path parameters

- `projectId` string, required

## Response `200`

Knowledge base entries retrieved

- object
  - `success` boolean, required
  - `data` object, nullable
    - `entries` KnowledgeBaseEntry[]
      - `id` string, required — Unique identifier for the entry
      - `title` string, required — Title of the knowledge base entry
      - `content` string, required — Content of the knowledge base entry
      - `date` string, date-time — Creation date
      - `previewHtml` string — Rendered HTML of the entry, kept as its preview. Send this for an uploaded email so it can be shown and used as a design reference.
      - `thumbnailUrl` string — URL of a thumbnail image for the entry.
      - `screenshotUrl` string — URL of a full screenshot of the entry.
      - `referenceOrigin` 'favorite' | 'upload' | 'manual' — Marks the entry as a design reference the email writer should learn from, and records where it came from. Omit for an ordinary note — an entry without it is never treated as a reference.
    - `total` integer
  - `error` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Resource not found

## Changes

- **2026-09-02** `e4d1d87bfcbe` — 4 info
  - added the optional property `allOf[subschema #2]/data/entries/items/previewHtml` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/entries/items/referenceOrigin` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/entries/items/screenshotUrl` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/entries/items/thumbnailUrl` to the response with the `200` status

[Change history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/projects/:projectId/knowledge-base/get.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/e4d1d87bfcbe/schema)