---
title: "Get Public Presentation Catalog"
method: GET
path: "/v2/public/presentations/catalog"
tags: ["presentations"]
---

# Get Public Presentation Catalog

`GET /v2/public/presentations/catalog`

## Request

- Base URL: `https://api.sanka.com`
- URL: `https://api.sanka.com/v2/public/presentations/catalog`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sankahq/apis/sanka-public-api/docs/v2/public/presentations/catalog/get.ts> (a function with typed inputs; its response is checked against the schema)

Layouts, blocks with JSON Schemas and limits, themes, icons, guidance and features.

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-Workspace-Code` string

## Response `200`

Successful Response

- GetPublicPresentationCatalog200Envelope
  - `success` true, required
  - `data` PresentationCatalogData, required
    - `schemaVersions` string[], required
    - `features` string[]: Optional capabilities this workspace may use, e.g. `freeform`.
    - `pageSizes` object[], required
    - `layouts` object[], required
    - `blocks` object[], required
    - `accents` object[], required
    - `themes` object[], required
    - `icons` string[], required: Lucide icon names allowed in card items.
    - `limits` object, required
    - `guidance` string[], required
    - `deckJsonSchema` object, required
    - `example` object, required
    - `freeform` object: Free placement (`positioning: free` slides): units, safe areas, grid, minimum and default frames, text sizes, shape tones and guidance.
  - `meta` EnvelopeMeta, required
    - `ctx_id` string, required
    - `pagination` PaginationMeta
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `next_cursor` string, nullable
    - `toast` ToastMessage
      - `variant` 'success' | 'error' | 'info' | 'warning', required
      - `code` string, required
      - `message` string, required
      - `i18n` ToastMessageI18n, required
        - `en` string, required
        - `ja` string, required

## Other responses

- `401`: Error response
- `403`: Error response
- `422`: Error response

## Changes

- **2026-10-18** `cadc7ef65a04`: 4 info
  - added the new optional `header` request parameter `X-Workspace-Code`
  - added the new optional `query` request parameter `workspace_id`
  - added the optional property `data/features` to the response with the `200` status
  - added the optional property `data/freeform` to the response with the `200` status
- **2026-10-09** `6224f51f9e33`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sankahq/apis/sanka-public-api/changes/v2/public/presentations/catalog/get.md)

---

[API](https://skmtc.dev/sankahq/apis/sanka-public-api.md) - [All operations](https://skmtc.dev/sankahq/apis/sanka-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sankahq/apis/sanka-public-api/revisions/16f03a9e3ab9?raw)