OCoctober

Get a theme

Returns a full design-system theme. Use query params to get a random theme, filter by platform, or fetch by id.

get/api/public/themes

Request

  • Base URL
    https://october.dev
  • Auth
    none declared

Query parameters

randomboolean

When true (default), returns a weighted-random theme.

platform'desktop-web' | 'mobile-app' | 'game'

Filter random selection by platform.

idstring

Fetch a specific theme by its slug id. When set, takes precedence over random.

Headers

October-Versionstring
Example:2026-08-01

Optional API version pin. Omit to use the current major version (see info.version). Backwards-incompatible changes ship under a new value.

Response

Theme object with full content.

idstring required

Theme slug id

namestring required
platform'desktop-web' | 'mobile-app' | 'game' required
contentstring

Prompt-ready markdown (70–100 lines) describing palette, typography, components, effects, animations, non-genericness rules.

Changes

No recorded changes to this operation across all 1 revision of this API.