Themes

Update the workspace's theme settings

Changes the workspace's theme naming policy. This changes what every realm on every cluster in the workspace serves, so it additionally requires the API key to have been minted for a workspace owner or admin; a key minted for any other role, including a cluster admin, gets 403 even with the themes:write scope.

Turning exact_theme_names on moves the workspace's existing themes to their exact names in the background; this does not block the response. A theme that cannot be moved right away (for example because its cluster is busy updating) completes the move on its next content replace instead.

Turning it off changes nothing immediately: each theme keeps its current served folder until its next content replace, from which point the folder changes on every replace again.

Required scope: themes:write

put/theme-settings

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/theme-settings
  • Auth: API key in header API-Key

Headers

API-Version'2026-06-01.beta' required

Request body

exact_theme_namesboolean required

When true, every theme in the workspace is served from a folder named exactly like the theme, and that name never changes across content replaces. When false (the default), the served folder changes on each replace, unless the theme was created by a platform migration.

Response

The request has succeeded.

exact_theme_namesboolean required

When true, every theme in the workspace is served from a folder named exactly like the theme, and that name never changes across content replaces. When false (the default), the served folder changes on each replace, unless the theme was created by a platform migration.

Changes

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