List themes

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.

get/v1/projects/{project_id}/themes

Authorizations

Authorizationstringrequired

http

Path parameters

project_idstringrequired

Amplitude project identifier, backed by the canonical app ID.

Example:12345
Constraints:pattern: ^[0-9]+$

Query parameters

cursorstring

Opaque cursor from pagination.next_cursor on the previous response. Numeric offsets are capped by the underlying search index (10,000 results per query). Well-formed pagination stops before that window; requests whose cursor would exceed it return 400 pagination_not_supported.

Constraints:nullable
limitinteger

Number of items to return. Defaults to 50, max 200.

Default:50
Constraints:min: 1max: 200
platformstring

Target platform. Guides and surveys without an explicit platform are returned as web.

Allowed values:webiosandroidreact-nativedesktopflutter
include_archivedboolean
Default:false

Response

application/json
200· Successful response.
dataobject[]required
Show child attributes
idstringrequired

Numeric theme identifier.

Constraints:pattern: ^[0-9]+$
objectstringrequired
project_idstringrequired
Constraints:pattern: ^[0-9]+$
namestringrequired
platformstringrequired

Target platform. Guides and surveys without an explicit platform are returned as web.

Allowed values:webiosandroidreact-nativedesktopflutter
is_defaultbooleanrequired

Whether this is the project's default theme for its platform. Guides and surveys with no theme_id use it.

is_internalbooleanrequired

Internal themes are per-guide or per-survey overrides created in the guide or survey editor. Lists omit them; get them by id through a guide or survey's theme_id.

is_archivedbooleanrequired
has_unpublished_changesbooleanrequired

Whether the unpublished draft differs from the live theme.

urlstringrequired

Admin URL for the theme. null for internal themes.

Constraints:format: urinullable
created_bystringrequired
Constraints:nullable
last_modified_bystringrequired
Constraints:nullable
created_atstringrequired
Constraints:format: date-timenullable
updated_atstringrequired
Constraints:format: date-timenullable
paginationobjectrequired
Show child attributes
next_cursorstringrequired

Cursor for the next page, or null on the last page. Chart list responses may stop before all project charts are enumerated because the search backend caps each query at 10,000 sorted hits.

Constraints:nullable
has_morebooleanrequired

Was this helpful?

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.