---
title: "List theme summaries available to a Workspace administrator"
method: GET
path: "/themes/available"
tags: ["Organization Themes"]
---

# List theme summaries available to a Workspace administrator

`GET /themes/available`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/themes/available`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

Returns a bounded page of built-ins and published Organization themes without exposing drafts, manifests, or asset inventory.

## Query parameters

- `workspace_id` string, required: Workspace ID
- `limit` integer: Maximum summaries to return
- `cursor` string: Opaque cursor for stable built-in-first pagination

## Response `200`

OK

- ThemeSummaryPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` ThemeSummary[], required
    - `assigned_workspace_count` integer, required
    - `built_in` boolean, required
    - `created_at` string, date-time
    - `description` string, required
    - `draft_revision` integer
    - `icon_pack` 'lucide' | 'heroicons-outline' | 'heroicons-solid' | 'phosphor' | 'tabler', required
    - `is_organization_default` boolean, required
    - `name` string, required
    - `organization_id` string
    - `published_revision` integer
    - `reference` ThemeReference, required
      - `id` string, required
      - `kind` 'built_in' | 'custom', required
      - `version` integer, required
    - `supported_schemes` string[], required
    - `updated_at` string, date-time
  - `next_cursor` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)