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.

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 results to return (1-100)

Example: 20

afterstringOptional

Pagination cursor from previous response

Example: eyJpZCI6IjEyMyJ9

Responses

200

Themes retrieved successfully

application/json

hasMorebooleanRequired

Whether more results are available

Example: true

nextCursorstring · nullableOptional

Cursor for next page, null if no more results

Example: eyJpZCI6IjQ1NiJ9

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