Get Themes

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

GET /api/v1/themes

List available themes

cURL

curl --request GET \
  --url https://slides-api.getalai.com/api/v1/themes \
  --header 'Authorization: Bearer <token>'

200

{
  "themes": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ]
}

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.

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.

---

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

curl -X GET "https://slides-api.getalai.com/api/v1/themes" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

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

---

Using a Theme ID in Presentation Generation

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"
    }
  }'

Authorizations

Authorization · string · header · required

Your Alai API key. Get one from your account settings at app.getalai.com

Response

200

application/json

Successful Response

themes · ThemeSummary · object[] · required

Themes available to the authenticated user

Show child attributes