---
title: "List immutable published revisions"
method: GET
path: "/themes/{id}/revisions"
tags: ["Organization Themes"]
---

# List immutable published revisions

`GET /themes/{id}/revisions`

## Request

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

## Path parameters

- `id` string, required: Organization theme ID

## Query parameters

- `organization_id` string, required: Organization ID
- `limit` integer: Maximum revisions to return
- `cursor` string: Opaque cursor for stable newest-first pagination

## Response `200`

OK

- PublishedRevisionPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` PublishedRevision[], required
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `manifest` ThemeManifest, required
      - `assets` ThemeAsset[], required
        - `alt` string
        - `id` string, required
        - `mimeType` 'image/png' | 'image/jpeg' | 'image/webp' | 'image/avif', required
        - `slot` 'background-texture' | 'sidebar-decoration' | 'header-decoration' | 'empty-state-illustration' | 'loading-illustration', required
        - `sourceUrl` string, required
      - `description` string, required
      - `fonts` ThemeFontFace[], required
        - `display` 'swap' | 'fallback' | 'optional', required
        - `family` string, required
        - `format` 'woff2', required
        - `id` string, required
        - `sourceUrl` string, required
        - `style` 'normal' | 'italic', required
        - `weight` integer, required
      - `iconPack` 'lucide' | 'heroicons-outline' | 'heroicons-solid' | 'phosphor' | 'tabler', required
      - `id` string, required
      - `name` string, required
      - `revision` string, required
      - `schemaVersion` 1, required
      - `schemes` ThemeSchemes, required
        - `dark` ThemeSchemeManifest
          - `colors` ThemeColorTokens, required
            - `actionDestructive` string, required
            - `actionDestructiveActive` string, required
            - `actionDestructiveHover` string, required
            - `actionDestructiveInk` string, required
            - `actionFocal` string, required
            - `actionFocalActive` string, required
            - `actionFocalHover` string, required
            - `actionFocalInk` string, required
            - `actionLink` string, required
            - `actionLinkHover` string, required
            - `actionOrdinary` string, required
            - `actionOrdinaryActive` string, required
            - `actionOrdinaryBorder` string, required
            - `actionOrdinaryHover` string, required
            - `actionOrdinaryInk` string, required
            - `actionPrimary` string, required
            - `actionPrimaryActive` string, required
            - `actionPrimaryHover` string, required
            - `actionPrimaryInk` string, required
            - `actionQuiet` string, required
            - `actionQuietActive` string, required
            - `actionQuietHover` string, required
            - `actionQuietInk` string, required
            - `border` string, required
            - `brand` string, required
            - `brandInk` string, required
            - `browserChrome` string, required
            - `browserSurface` string, required
            - `canvas` string, required
            - `cardHover` string, required
            - `caret` string, required
            - `chart1` string, required
            - `chart2` string, required
            - `chart3` string, required
            - `chart4` string, required
            - `chart5` string, required
            - `chrome` string, required
            - `chromeInk` string, required
            - `danger` string, required
            - `dangerInk` string, required
            - `disabled` string, required
            - `disabledInk` string, required
            - `field` string, required
            - `fieldBorder` string, required
            - `fieldDisabled` string, required
            - `fieldDisabledInk` string, required
            - `fieldFocus` string, required
            - `fieldHover` string, required
            - `fieldInk` string, required
            - `focus` string, required
            - `info` string, required
            - `infoInk` string, required
            - `ink` string, required
            - `input` string, required
            - `link` string, required
            - `mutedInk` string, required
            - `navigationActive` string, required
            - `navigationActiveInk` string, required
            - `navigationHover` string, required
            - `overlay` string, required
            - `scrim` string, required
            - `selection` string, required
            - `selectionInk` string, required
            - `sidebar` string, required
            - `sidebarActive` string, required
            - `sidebarActiveInk` string, required
            - `sidebarBorder` string, required
            - `sidebarInk` string, required
            - `success` string, required
            - `successInk` string, required
            - `surface` string, required
            - `surfaceRaised` string, required
            - `surfaceSunken` string, required
            - `warning` string, required
            - `warningInk` string, required
            - `workspace` string, required
            - `workspaceInk` string, required
          - `components` ThemeComponentRecipes, required
            - `badge` 'solid' | 'tonal' | 'outlined', required
            - `button` 'solid' | 'tonal' | 'outlined' | 'precise' | 'pill' | 'dither', required
            - `card` 'flat' | 'outlined' | 'paper' | 'lifted' | 'dither', required
            - `checkbox` 'solid' | 'tonal' | 'outlined', required
            - `chip` 'solid' | 'tonal' | 'outlined', required
            - `container` 'flat' | 'outlined' | 'tinted', required
            - `decoration` 'none' | 'editorial' | 'playful' | 'botanical' | 'study' | 'tactile' | 'precision' | 'dither', required
            - `dialog` 'flat' | 'outlined' | 'elevated', required
            - `editorChrome` 'neutral' | 'compact' | 'precision', required
            - `emptyState` 'plain' | 'illustrated' | 'framed', required
            - `input` 'filled' | 'outlined' | 'underlined', required
            - `link` 'underlined' | 'subtle' | 'plain', required
            - `list` 'divided' | 'spaced' | 'plain', required
            - `loadingState` 'spinner' | 'pulse' | 'skeleton', required
            - `navigation` 'quiet' | 'tonal' | 'outlined', required
            - `pagination` 'quiet' | 'outlined' | 'pill', required
            - `popover` 'flat' | 'outlined' | 'elevated', required
            - `radio` 'solid' | 'tonal' | 'outlined', required
            - `select` 'filled' | 'outlined' | 'underlined', required
            - `switch` 'solid' | 'tonal' | 'outlined', required
            - `table` 'ruled' | 'striped' | 'plain', required
            - `tabs` 'underline' | 'pill' | 'segmented', required
            - `toast` 'flat' | 'outlined' | 'elevated', required
            - `toolbar` 'flat' | 'outlined' | 'floating', required
          - `elevation` ThemeElevationTokens, required
            - `card` string, required
            - `dialog` string, required
            - `focalAction` string, required
            - `popover` string, required
          - `motion` ThemeMotionTokens, required
            - `entry` ThemeMotionRecipe, required
              - …
            - `exit` ThemeMotionRecipe, required
              - …
            - `hover` ThemeMotionRecipe, required
              - …
            - `loading` ThemeMotionRecipe, required
              - …
            - `pageTransition` ThemeMotionRecipe, required
              - …
            - `press` ThemeMotionRecipe, required
              - …
            - `reducedMotion` 'instant' | 'crossfade', required
            - `selection` ThemeMotionRecipe, required
              - …
          - `protectedEditor` ThemeProtectedEditorTokens, required
            - `canvasGrid` string, required
            - `canvasHandle` string, required
            - `canvasPasteboard` string, required
            - `canvasSafeArea` string, required
            - `canvasSelection` string, required
            - `editorBorder` string, required
            - `editorCanvas` string, required
            - `editorControl` string, required
            - `editorControlHover` string, required
            - `editorFocus` string, required
            - `editorFocusBorder` string, required
            - `editorMuted` string, required
            - `editorPanel` string, required
            - `editorText` string, required
            - `protectedGlyph` string, required
            - `timelineClip` string, required
            - `timelinePlayhead` string, required
            - `timelineSelection` string, required
            - `timelineTrack` string, required
            - `timelineWaveform` string, required
          - `shape` ThemeCornerTokens, required
            - `borderStyle` 'solid' | 'dashed', required
            - `borderWidth` string, required
            - `radius` string, required
            - `radiusLg` string, required
            - `radiusMd` string, required
            - `radiusMedia` string, required
            - `radiusPill` string, required
            - `radiusSm` string, required
          - `shell` ThemeShellTokens, required
            - `canvasTreatment` 'plain' | 'paper' | 'playful' | 'garden' | 'study' | 'tactile' | 'precision', required
            - `contentMaxWidth` string, required
            - `headerHeight` string, required
            - `mobileNavigationHeight` string, required
            - `sidebarWidth` string, required
          - `spacing` ThemeSpacingTokens, required
            - `base` string, required
            - `compactControlHeight` string, required
            - `componentGap` string, required
            - `controlHeight` string, required
            - `density` 'compact' | 'comfortable' | 'spacious', required
            - `pageGutter` string, required
            - `sectionGap` string, required
            - `touchTarget` string, required
          - `typography` ThemeTypographyTokens, required
            - `body` ThemeTypographyRoleTokens, required
              - …
            - `code` ThemeTypographyRoleTokens, required
              - …
            - `display` ThemeTypographyRoleTokens, required
              - …
            - `label` ThemeTypographyRoleTokens, required
              - …
            - `metadata` ThemeTypographyRoleTokens, required
              - …
            - `title` ThemeTypographyRoleTokens, required
              - …
        - `light` ThemeSchemeManifest
          - `colors` ThemeColorTokens, required
            - `actionDestructive` string, required
            - `actionDestructiveActive` string, required
            - `actionDestructiveHover` string, required
            - `actionDestructiveInk` string, required
            - `actionFocal` string, required
            - `actionFocalActive` string, required
            - `actionFocalHover` string, required
            - `actionFocalInk` string, required
            - `actionLink` string, required
            - `actionLinkHover` string, required
            - `actionOrdinary` string, required
            - `actionOrdinaryActive` string, required
            - `actionOrdinaryBorder` string, required
            - `actionOrdinaryHover` string, required
            - `actionOrdinaryInk` string, required
            - `actionPrimary` string, required
            - `actionPrimaryActive` string, required
            - `actionPrimaryHover` string, required
            - `actionPrimaryInk` string, required
            - `actionQuiet` string, required
            - `actionQuietActive` string, required
            - `actionQuietHover` string, required
            - `actionQuietInk` string, required
            - `border` string, required
            - `brand` string, required
            - `brandInk` string, required
            - `browserChrome` string, required
            - `browserSurface` string, required
            - `canvas` string, required
            - `cardHover` string, required
            - `caret` string, required
            - `chart1` string, required
            - `chart2` string, required
            - `chart3` string, required
            - `chart4` string, required
            - `chart5` string, required
            - `chrome` string, required
            - `chromeInk` string, required
            - `danger` string, required
            - `dangerInk` string, required
            - `disabled` string, required
            - `disabledInk` string, required
            - `field` string, required
            - `fieldBorder` string, required
            - `fieldDisabled` string, required
            - `fieldDisabledInk` string, required
            - `fieldFocus` string, required
            - `fieldHover` string, required
            - `fieldInk` string, required
            - `focus` string, required
            - `info` string, required
            - `infoInk` string, required
            - `ink` string, required
            - `input` string, required
            - `link` string, required
            - `mutedInk` string, required
            - `navigationActive` string, required
            - `navigationActiveInk` string, required
            - `navigationHover` string, required
            - `overlay` string, required
            - `scrim` string, required
            - `selection` string, required
            - `selectionInk` string, required
            - `sidebar` string, required
            - `sidebarActive` string, required
            - `sidebarActiveInk` string, required
            - `sidebarBorder` string, required
            - `sidebarInk` string, required
            - `success` string, required
            - `successInk` string, required
            - `surface` string, required
            - `surfaceRaised` string, required
            - `surfaceSunken` string, required
            - `warning` string, required
            - `warningInk` string, required
            - `workspace` string, required
            - `workspaceInk` string, required
          - `components` ThemeComponentRecipes, required
            - `badge` 'solid' | 'tonal' | 'outlined', required
            - `button` 'solid' | 'tonal' | 'outlined' | 'precise' | 'pill' | 'dither', required
            - `card` 'flat' | 'outlined' | 'paper' | 'lifted' | 'dither', required
            - `checkbox` 'solid' | 'tonal' | 'outlined', required
            - `chip` 'solid' | 'tonal' | 'outlined', required
            - `container` 'flat' | 'outlined' | 'tinted', required
            - `decoration` 'none' | 'editorial' | 'playful' | 'botanical' | 'study' | 'tactile' | 'precision' | 'dither', required
            - `dialog` 'flat' | 'outlined' | 'elevated', required
            - `editorChrome` 'neutral' | 'compact' | 'precision', required
            - `emptyState` 'plain' | 'illustrated' | 'framed', required
            - `input` 'filled' | 'outlined' | 'underlined', required
            - `link` 'underlined' | 'subtle' | 'plain', required
            - `list` 'divided' | 'spaced' | 'plain', required
            - `loadingState` 'spinner' | 'pulse' | 'skeleton', required
            - `navigation` 'quiet' | 'tonal' | 'outlined', required
            - `pagination` 'quiet' | 'outlined' | 'pill', required
            - `popover` 'flat' | 'outlined' | 'elevated', required
            - `radio` 'solid' | 'tonal' | 'outlined', required
            - `select` 'filled' | 'outlined' | 'underlined', required
            - `switch` 'solid' | 'tonal' | 'outlined', required
            - `table` 'ruled' | 'striped' | 'plain', required
            - `tabs` 'underline' | 'pill' | 'segmented', required
            - `toast` 'flat' | 'outlined' | 'elevated', required
            - `toolbar` 'flat' | 'outlined' | 'floating', required
          - `elevation` ThemeElevationTokens, required
            - `card` string, required
            - `dialog` string, required
            - `focalAction` string, required
            - `popover` string, required
          - `motion` ThemeMotionTokens, required
            - `entry` ThemeMotionRecipe, required
              - …
            - `exit` ThemeMotionRecipe, required
              - …
            - `hover` ThemeMotionRecipe, required
              - …
            - `loading` ThemeMotionRecipe, required
              - …
            - `pageTransition` ThemeMotionRecipe, required
              - …
            - `press` ThemeMotionRecipe, required
              - …
            - `reducedMotion` 'instant' | 'crossfade', required
            - `selection` ThemeMotionRecipe, required
              - …
          - `protectedEditor` ThemeProtectedEditorTokens, required
            - `canvasGrid` string, required
            - `canvasHandle` string, required
            - `canvasPasteboard` string, required
            - `canvasSafeArea` string, required
            - `canvasSelection` string, required
            - `editorBorder` string, required
            - `editorCanvas` string, required
            - `editorControl` string, required
            - `editorControlHover` string, required
            - `editorFocus` string, required
            - `editorFocusBorder` string, required
            - `editorMuted` string, required
            - `editorPanel` string, required
            - `editorText` string, required
            - `protectedGlyph` string, required
            - `timelineClip` string, required
            - `timelinePlayhead` string, required
            - `timelineSelection` string, required
            - `timelineTrack` string, required
            - `timelineWaveform` string, required
          - `shape` ThemeCornerTokens, required
            - `borderStyle` 'solid' | 'dashed', required
            - `borderWidth` string, required
            - `radius` string, required
            - `radiusLg` string, required
            - `radiusMd` string, required
            - `radiusMedia` string, required
            - `radiusPill` string, required
            - `radiusSm` string, required
          - `shell` ThemeShellTokens, required
            - `canvasTreatment` 'plain' | 'paper' | 'playful' | 'garden' | 'study' | 'tactile' | 'precision', required
            - `contentMaxWidth` string, required
            - `headerHeight` string, required
            - `mobileNavigationHeight` string, required
            - `sidebarWidth` string, required
          - `spacing` ThemeSpacingTokens, required
            - `base` string, required
            - `compactControlHeight` string, required
            - `componentGap` string, required
            - `controlHeight` string, required
            - `density` 'compact' | 'comfortable' | 'spacious', required
            - `pageGutter` string, required
            - `sectionGap` string, required
            - `touchTarget` string, required
          - `typography` ThemeTypographyTokens, required
            - `body` ThemeTypographyRoleTokens, required
              - …
            - `code` ThemeTypographyRoleTokens, required
              - …
            - `display` ThemeTypographyRoleTokens, required
              - …
            - `label` ThemeTypographyRoleTokens, required
              - …
            - `metadata` ThemeTypographyRoleTokens, required
              - …
            - `title` ThemeTypographyRoleTokens, required
              - …
      - `supportedSchemes` string[], required
    - `published_at` string, date-time, required
    - `published_by` string, required
    - `revision` integer, required
    - `source_revision` integer
    - `theme_id` string, required
  - `next_cursor` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `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)