Skip to main content

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 get <presentationId> (or slideless get <presentationId> --json).

​
When to use

Inspect one presentation in detail — full token list, per-token access counts, last-accessed timestamps, status. The owner of the presentation must match the API key’s user. For a list of all your presentations, use GET /listMyPresentations instead.

​
Endpoint

GET https://europe-west1-slideless-ai.cloudfunctions.net/getSharedPresentationInfo/{presentationId}
The presentationId is in the URL path.

​
Auth

HeaderValue
Authorizationcko_… (or cka_…) — must belong to the presentation’s owner
Recommended scope: presentations:read.

​
Path parameters

ParamTypeDescription
presentationIdUUIDv7 stringThe presentation ID

​
Response (200)

{
  "success": true,
  "data": {
    "id": "0192f1c3-...",
    "ownerId": "user-uuid",
    "organizationId": "org-uuid",
    "title": "Q4 review",
    "version": 3,
    "createdAt": "2026-04-15T10:00:00.000Z",
    "updatedAt": "2026-04-18T15:30:00.000Z",
    "expiresAt": null,
    "totalViews": 47,
    "lastViewedAt": "2026-04-19T09:12:00.000Z",
    "primaryShareUrl": "https://app.slideless.ai/share/0192f1c3-...?token=AbCdEf...",
    "tokens": [
      {
        "tokenId": "0192f1c3-...",
        "name": "default",
        "createdAt": "2026-04-15T10:00:00.000Z",
        "revoked": false,
        "revokedAt": null,
        "lastAccessedAt": "2026-04-19T09:12:00.000Z",
        "accessCount": 42,
        "shareUrl": "https://app.slideless.ai/share/0192f1c3-...?token=AbCdEf..."
      },
      {
        "tokenId": "0192f1c3-...",
        "name": "John at Acme",
        "createdAt": "2026-04-16T11:00:00.000Z",
        "revoked": false,
        "revokedAt": null,
        "lastAccessedAt": "2026-04-17T14:22:00.000Z",
        "accessCount": 5,
        "shareUrl": "https://app.slideless.ai/share/0192f1c3-...?token=GhIjKl..."
      }
    ]
  }
}
FieldTypeDescription
idstringThe presentationId
ownerId, organizationIdstringOwnership context
title, versionvariousSee Presentations concept
totalViews, lastViewedAtaggregatedAcross all tokens
primaryShareUrlstring | nullConvenience — first non-revoked token’s URL
tokensarrayOne entry per share token (active or revoked)
Each token entry:
FieldDescription
tokenIdInternal ID (used for revocation)
nameHuman-readable label
accessCountTotal views via this specific token
lastAccessedAtMost recent view through this token
revoked + revokedAtRevocation status
shareUrlThe share URL embedding this token

​
Examples

​
curl

SHARE_ID="0192f1c3-..."

curl -sS \
  -H "Authorization: Bearer $SLIDELESS_API_KEY" \
  "https://europe-west1-slideless-ai.cloudfunctions.net/getSharedPresentationInfo/$SHARE_ID"

​
Node.js

const presentationId = '0192f1c3-...';

const res = await fetch(
  `https://europe-west1-slideless-ai.cloudfunctions.net/getSharedPresentationInfo/${presentationId}`,
  { headers: { 'Authorization': `Bearer ${process.env.SLIDELESS_API_KEY}` } }
);

const { data: info } = await res.json();
console.log(`${info.title} — v${info.version} — ${info.totalViews} total views`);
for (const t of info.tokens) {
  console.log(`  • ${t.name} (${t.accessCount} views, ${t.revoked ? 'revoked' : 'active'})`);
}

​
Errors

StatusCodeCauseFix
400invalid-argumentMissing presentationId in pathInclude the share ID after the slash
401unauthenticatedMissing or invalid API keySet Authorization
403permission-deniedKey’s user is not the ownerUse a key from the owner’s account
404not-foundNo presentation with that IDVerify the ID via listMyPresentations
405method-not-allowedUsed POST/PUT/etc.Use GET
500internalBackend errorRetry with backoff