GET /themes

List all themes available in your workspace, including custom themes.

List the themes available in the authenticated workspace. Use the returned id values as themeId in generation requests.

What themes are

A theme controls the visual style of a generated Gamma — colors, fonts, backgrounds, and layout feel. Every workspace has access to Gamma's standard theme library plus any custom themes created in the workspace. Pass a theme's id as themeId in POST /generations or POST /generations/from-template to apply it.

Pagination

Results are cursor-paginated. Each response includes hasMore (boolean) and nextCursor (string or null). To fetch the next page, pass the nextCursor value as the after query parameter. Use limit (1-50, default 20) to control page size. Use query to filter themes by name, or type=standard|custom to limit results to built-in or workspace themes. Keep the same type value across paginated requests.

List themes

get

Lists all themes available to the workspace, including standard themes and custom workspace themes.

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Query parameters

querystringOptional

Search query to filter themes by name

Example: corporate

limitnumber · min: 1 · max: 50Optional

Maximum number of themes to return

Example: 20

afterstringOptional

Cursor for pagination (from previous response's nextCursor)

Example: eyJpZCI6IjEyMyJ9

typestring · enumOptional

Filter by theme type: "standard" for built-in themes, "custom" for workspace-created themes. Must be kept consistent across paginated requests; changing it mid-pagination will yield inconsistent results.

Example: customPossible values:

Responses

200

Themes retrieved successfully

application/json

hasMorebooleanRequired

Whether more results exist beyond this page

Example: true

nextCursorstring · nullableRequired

Cursor for fetching the next page (null if no more results)

Example: eyJpZCI6IjQ1NiJ9

400

Invalid request parameters

401

Invalid or missing API key

get

/v1.0/themes

HTTPcURLJavaScriptPython

GET /v1.0/themes HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "theme_abc123",
      "name": "Corporate Blue",
      "colorKeywords": [
        "blue",
        "professional",
        "modern"
      ],
      "toneKeywords": [
        "formal",
        "business"
      ],
      "type": "standard"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjQ1NiJ9"
}

For guidance on when to fetch theme IDs and how to use them in requests, see Use themes and folders.

Related

• Use themes and folders for workflow guidance

• POST /generations if you want to apply a returned themeId