---
title: "List the Slack message preview catalog"
method: GET
path: "/v1/admin/slack-preview-messages"
tags: ["admin"]
---

# List the Slack message preview catalog

`GET /v1/admin/slack-preview-messages`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/slack-preview-messages`
- Auth: HTTP bearer

Every catalogued Patricia message with the metadata the console needs to pick and explain one, plus whether this environment holds a credential for the one workspace a preview may be posted into. Reads the database only; makes no Slack call. Internal admin users only.

## Response `200`

Successful Response

- SlackPreviewMessageList: The whole catalog plus whether this environment can send at all.
  - `items` SlackPreviewMessageRow[], required
    - `id` string, required
    - `group` string, required
    - `name` string, required
    - `label` string, required
    - `kind` string, required
    - `sendable` boolean, required: False for a message production only ever writes over an earlier card.
    - `note` string, required: What the dummy data stands for, or why the entry is never posted on its own.
  - `count` integer, required
  - `sendable_count` integer, required
  - `groups` string[], required: Catalog group order, so the picker groups without inventing an order.
  - `send_available` boolean, required: False when no ACTIVE Slack install resolves for the allowlisted workspace, so the console can say sending is unavailable instead of offering a button that always fails.
  - `workspace_name` string, required: The one workspace a preview can ever be posted into.

## Other responses

- `401`: Unauthorized
- `403`: Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)
- `422`: Validation error

---

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