> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getalai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Themes

> Returns theme IDs and names for all system themes and user themes accessible to the authenticated user.

Retrieve the themes available to the authenticated user.

This endpoint returns both system themes and any user themes you can access. Use the returned `id` values as `presentation_options.theme_id` when generating presentations.

<Note>
  `theme_id` now primarily expects a theme ID from this endpoint. Legacy theme display names are still accepted for backward compatibility, but they are deprecated.
</Note>

***

## Response

| Field    | Type  | Description                                        |
| -------- | ----- | -------------------------------------------------- |
| `themes` | array | List of themes available to the authenticated user |

### Theme Object

| Field  | Type   | Description                                                        |
| ------ | ------ | ------------------------------------------------------------------ |
| `id`   | string | Unique theme identifier to pass as `presentation_options.theme_id` |
| `name` | string | Human-readable theme display name                                  |

***

## Example Request

```bash theme={null}
curl -X GET "https://slides-api.getalai.com/api/v1/themes" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example Response

```json theme={null}
{
  "themes": [
    {
      "id": "27874e6b-8c1c-4301-bce7-d22e6e8df7d6",
      "name": "Simple Light"
    }
  ]
}
```

***

## Using a Theme ID in Presentation Generation

```bash theme={null}
curl -X POST "https://slides-api.getalai.com/api/v1/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_text": "Quarterly business review content...",
    "presentation_options": {
      "title": "QBR",
      "theme_id": "27874e6b-8c1c-4301-bce7-d22e6e8df7d6",
      "slide_range": "6-10"
    }
  }'
```


## OpenAPI

````yaml GET /api/v1/themes
openapi: 3.1.0
info:
  title: Alai API
  description: API endpoints for programmatic access to Alai presentation generation
  version: 1.0.0
servers:
  - url: https://slides-api.getalai.com
security:
  - BearerAuth: []
paths:
  /api/v1/themes:
    get:
      tags:
        - External API
      summary: List available themes
      description: >-
        Returns theme IDs and names for all system themes and user themes
        accessible to the authenticated user.
      operationId: get_themes_api_v1_themes_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetThemesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GetThemesResponse:
      properties:
        themes:
          items:
            $ref: '#/components/schemas/ThemeSummary'
          type: array
          title: Themes
          description: Themes available to the authenticated user
      type: object
      required:
        - themes
      title: GetThemesResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ThemeSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique theme identifier
        name:
          type: string
          title: Name
          description: Theme display name
      type: object
      required:
        - id
        - name
      title: ThemeSummary
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Your Alai API key. Get one from your account settings at app.getalai.com

````