Skip to main content
GET
/
api
/
v1
/
presentations
List all presentations
curl --request GET \
  --url https://slides-api.getalai.com/api/v1/presentations \
  --header 'Authorization: Bearer <token>'
{
  "presentations": [
    {
      "presentation_id": "<string>",
      "title": "<string>",
      "slide_count": 123,
      "theme_id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "thumbnail_url": "<string>"
    }
  ],
  "total": 123
}
Retrieve a list of all presentations belonging to the authenticated user. Returns presentations sorted by creation date (newest first).

​
Response

FieldTypeDescription
presentationsarrayList of presentation summaries
totalintegerTotal number of presentations

​
Presentation Summary

Each presentation in the array contains:
FieldTypeDescription
presentation_idstringUnique identifier for the presentation
titlestringTitle of the presentation
slide_countintegerNumber of slides in the presentation
theme_idstringVisual theme applied to the presentation
created_atstringISO 8601 timestamp when created
updated_atstringISO 8601 timestamp when last modified
thumbnail_urlstringURL to the presentation thumbnail (may be null)

​
Example Response

{
  "presentations": [
    {
      "presentation_id": "abc123-def456-789",
      "title": "Q4 Sales Report",
      "slide_count": 8,
      "theme_id": "NEBULA_DARK",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T14:22:00Z",
      "thumbnail_url": "https://..."
    },
    {
      "presentation_id": "xyz789-abc123-456",
      "title": "Product Roadmap 2025",
      "slide_count": 12,
      "theme_id": "AMETHYST_LIGHT",
      "created_at": "2025-01-10T09:00:00Z",
      "updated_at": "2025-01-12T16:45:00Z",
      "thumbnail_url": "https://..."
    }
  ],
  "total": 2
}

​
Example Request

curl -X GET "https://slides-api.getalai.com/api/v1/presentations" \
  -H "Authorization: Bearer YOUR_API_KEY"
Use the presentation_id from this response to perform operations like adding slides, exporting, or deleting presentations.

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

​
presentations
PresentationSummary · object[]
required

List of presentations

​
total
integer
required

Total number of presentations