Documentation Index
Fetch the complete documentation index at: https://docs.slideless.ai/llms.txt
Use this file to discover all available pages before exploring further.
For most use cases, the
slideless CLI is easier than calling this endpoint directly. The CLI command equivalent is slideless list (or slideless list --json for machine output).When to use
Enumerate every presentation the API key’s user can access — owned decks plus decks the user has been invited to as a dev collaborator. Returns up to 100 results, ordered byupdatedAt descending. Each row carries a role field (owner or dev).
For full per-presentation metadata (token list, per-token access counts), use GET /getSharedPresentationInfo/{presentationId}.
Endpoint
Auth
| Header | Value |
|---|---|
Authorization | cko_… (or cka_…) |
presentations:read.
Request
No body, no query parameters. The user is inferred from the API key.Response (200)
| Field | Type | Description |
|---|---|---|
id | UUIDv7 string | The presentationId |
title | string | Display title |
version | number | Current version |
role | "owner" | "dev" | Caller’s role on this deck |
createdAt, updatedAt, lastViewedAt | ISO 8601 string | null | Timestamps |
totalViews | number | Sum of views across all share tokens |
shareUrl | string | null | An active share URL (first non-revoked token), or null if the deck has no live token |
Pagination
Capped at 100 results in v1. There is no cursor; if you have more than 100 presentations, the list page in the dashboard is the recommended path.Examples
curl
Node.js
Errors
| Status | Code | Cause | Fix |
|---|---|---|---|
401 | unauthenticated | Missing or invalid API key | Set Authorization |
405 | method-not-allowed | Used POST/PUT/etc. | Use GET |
500 | internal | Backend error | Retry with backoff |
Next
- GET /getSharedPresentationInfo/ — Full metadata for one presentation, including all share tokens.