amp themes

이 페이지는 아직 귀하의 언어로 번역되지 않았습니다. 현재 작업 중이므로 곧 다시 확인해 주십시오.

amp themes manages the themes that guides and surveys share. Changes apply to a theme's draft; publish the draft in Amplitude. Read commands require guides:read and surveys:read; create and update require guides:write and surveys:write.

amp themes list

Returns the guides and surveys themes in the project, newest first. Results use the standard Developer API list envelope with cursor pagination (cursor, limit). List items omit config; get a theme by id to read it.

Internal themes (per-guide or per-survey overrides) are not listed. Read them by id through a guide or survey's theme_id. Assistant themes are not part of this API.

bash
amp themes list --project <project_id> --platform web

Requires the guides:read and surveys:read scopes.

amp themes get

Returns a guides and surveys theme. config is the live theme by default. Archived themes return 404.

bash
amp themes get --project <project_id> --theme <theme_id> --include-unpublished-changes

Requires the guides:read and surveys:read scopes.

amp themes create

Creates a guides and surveys theme. Both the live theme and the draft start as Amplitude's built-in default theme, and config is merged into the draft (see ThemeConfigPatch), so you only send the values you want to change. Nothing changes for users until the draft is published in Amplitude. The response carries the draft config.

The new theme isn't the default unless the platform has no default theme and you can publish theme changes, in which case Amplitude makes it the default, as it does in the theme editor. A platform that isn't enabled for the project returns 400. Publishing, archiving, and changing the default theme are not available via API.

bash
amp themes create --project <project_id> --name "Brand"

Requires the guides:write and surveys:write scopes.

amp themes update

Renames a theme or changes its draft. config is merged into the current draft (see ThemeConfigPatch): send only the values you want to change, and null to reset a value to Amplitude's built-in default. The live theme is not changed; publish the draft in Amplitude. The response carries the full draft config.

To make sure nobody changed the theme since you read it, send the updated_at from your last read; if the theme has changed since, the update returns 409 and nothing is written. Omit updated_at to skip the check: concurrent patches then both apply, and a later one wins for any value both set. The check runs before the write rather than atomically with it, so it narrows but does not close that window. Internal themes return 409 with error_code: theme_is_internal; edit them on their guide or survey in Amplitude.

bash
amp themes update --project <project_id> --theme <theme_id> --config '{"lightMode":{"varDefaults":{"--base-accent":"rgb(37, 99, 235)"}}}'

Requires the guides:write and surveys:write scopes.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서