---
title: "Guide Messages Endpoint"
method: GET
path: "/guide/messages"
tags: ["guide"]
---

# Guide Messages Endpoint

`GET /guide/messages`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/guide/messages`
- Auth: HTTP bearer

The user's thread, oldest first — what the panel hydrates from. Rows
are the user's own: the thread is keyed by user_id.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- GuideThreadMessage[]
  - `id` string, required
  - `scope` 'global' | 'channel' | 'project', required
  - `scope_id` string, nullable, required
  - `role` 'user' | 'assistant' | 'nudge', required
  - `content` string, required
  - `nudge_id` string, nullable, required
  - `category` string, nullable, required
  - `chips` GuideChip[], required
    - `label` string, required
    - `kind` 'navigate' | 'question' | 'preset', required
    - `value` string, required
    - `highlight` string, nullable
  - `preset` GuidePreset, required: A preset message as the panel renders it (generation/guide/presets.py).
    - `id` string, required
    - `title` string, required
    - `blocks` union[], required
      - union
        - GuideTextBlock
          - `type` 'text'
          - `text` string, required
        - GuideTipBlock
          - `type` 'tip'
          - `text` string, required
        - GuideTemplatesBlock: The channel style's two template images, as they are now.
          - `type` 'templates'
        - GuideListBlock: Numbered rows: steps to read, or options to pick from.
          - `type` 'list'
          - `items` GuideListItem[], required
            - `title` string, required
            - `detail` string, required
            - `link` string, nullable
            - `highlight` string, nullable
    - `page` string, nullable
    - `highlight` string, nullable
    - `route` string, nullable
  - `rating` 'up' | 'down', nullable
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/framesail/apis/framesail-api.md) · [All operations](https://skmtc.dev/framesail/apis/framesail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framesail/apis/framesail-api/revisions/12602eae0820?raw)