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.
/v1/projects/{project_id}/themesAuthorizations
Authorizationstringrequiredhttp
Path parameters
project_idstringrequiredAmplitude project identifier, backed by the canonical app ID.
12345pattern: ^[0-9]+$Query parameters
cursorstringOpaque 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.
nullablelimitintegerNumber of items to return. Defaults to 50, max 200.
50min: 1max: 200platformstringTarget platform. Guides and surveys without an explicit platform are
returned as web.
webiosandroidreact-nativedesktopflutterinclude_archivedbooleanfalseResponse
application/jsondataobject[]requiredShow child attributes
idstringrequiredNumeric theme identifier.
pattern: ^[0-9]+$objectstringrequiredproject_idstringrequiredpattern: ^[0-9]+$namestringrequiredplatformstringrequiredTarget platform. Guides and surveys without an explicit platform are
returned as web.
webiosandroidreact-nativedesktopflutteris_defaultbooleanrequiredWhether this is the project's default theme for its platform. Guides
and surveys with no theme_id use it.
is_internalbooleanrequiredInternal 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_archivedbooleanrequiredhas_unpublished_changesbooleanrequiredWhether the unpublished draft differs from the live theme.
urlstringrequiredAdmin URL for the theme. null for internal themes.
format: urinullablecreated_bystringrequirednullablelast_modified_bystringrequirednullablecreated_atstringrequiredformat: date-timenullableupdated_atstringrequiredformat: date-timenullablepaginationobjectrequiredShow child attributes
next_cursorstringrequiredCursor 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.
nullablehas_morebooleanrequiredWas 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.