Skip to main content
GET
/
api
/
v1
/
themes
List available themes
curl --request GET \
  --url https://slides-api.getalai.com/api/v1/themes \
  --header 'Authorization: Bearer <token>'
{
  "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

FieldTypeDescription
themesarrayList of themes available to the authenticated user

​
Theme Object

FieldTypeDescription
idstringUnique theme identifier to pass as presentation_options.theme_id
namestringHuman-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

Successful Response

​
themes
ThemeSummary · object[]
required

Themes available to the authenticated user