Sign In

List Slides

List slide generation requests with optional filtering and pagination.

GET /v1/platform/slides

Returns the slide generation requests for the authenticated workspace, ordered by creation time descending (newest first).

Example Request

curl https://api.tutorflow.io/v1/platform/slides \
  -H "Authorization: Bearer tf_platform_..."

Response

Returns an array of slide request objects. Each item is a subset of the full SlideResDto returned by Create Slide: id, slideId, status, title, description, language, theme, slideCount, slug, tier, mode, priceSnapshot, shareToken, previewUrl, publicUrl, isTerminal, createdAt, and completedAt.

Example Response

[
  {
    "id": "61f1b111-0df3-4de3-a83f-d4b10304949d",
    "slideId": "669b977b-0007-40b9-8339-2b4e1d8e7c8e",
    "status": "COMPLETED",
    "title": "The Mediterranean Diet, Explained",
    "description": "A 6-slide overview of the Mediterranean diet…",
    "language": "en",
    "theme": null,
    "slideCount": 6,
    "slug": "the-mediterranean-diet-explained-1602dc2c",
    "tier": "default",
    "mode": "sync",
    "priceSnapshot": {
      "category": "slide",
      "catalogKey": "slide.default",
      "tier": "default",
      "unit": "slide",
      "unitPrice": 0.03,
      "units": 6,
      "amountUsd": 0.18,
      "currency": "USD",
      "source": "platform_pricing_catalog_v2"
    },
    "shareToken": "fda025e5ea364bf30ea46671582d6859",
    "previewUrl": "https://tutorflow.io/en/platform/slides/edit/...",
    "publicUrl": "https://tutorflow.io/en/platform/slides/fda025e5ea364bf30ea46671582d6859",
    "isTerminal": true,
    "createdAt": "2026-04-25T04:14:15.756Z",
    "completedAt": "2026-04-25T04:14:40.940Z"
  }
]

Notes for Agents

  • Use this endpoint to recover a deck whose id you've forgotten — match by slug or createdAt.
  • previewUrl in list responses uses the current editToken at request time. If the link is older than ~1 hour you may want to call GET /v1/platform/slides/:id (which extends the token) before sharing.
  • The response is not paginated. Workspaces with very high volume should filter on the client.
Update SlideAdmin Statistics