> ## Documentation Index
> Fetch the complete documentation index at: https://developer.demand-iq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List slides



## OpenAPI

````yaml /openapi.json get /api/decks/{deckId}/slides
openapi: 3.0.0
info:
  title: AI Presentations API
  version: 1.0.0
  description: >-
    REST API for AI Presentations — an AI-powered presentation platform with
    narrated slides, live Q&A, and deck management.


    **Authentication**: Most endpoints require a session cookie obtained from
    `POST /api/auth/login`. Presentation playback endpoints (`/api/qa`,
    `/api/narration/*`) also accept a `presentationId` for unauthenticated
    viewer access.
  contact:
    name: Demand IQ
    url: https://demand-iq.com
servers:
  - url: https://app.demand-iq.com
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: Decks
    description: Manage presentation decks
  - name: Slides
    description: Manage slides within a deck
  - name: FAQs
    description: Manage pre-built Q&A pairs
  - name: Branding
    description: Colors, logo, and call-to-action configuration
  - name: Q&A
    description: Live question answering and Q&A settings
  - name: Narration
    description: Text-to-speech synthesis
  - name: Presentations
    description: Create and manage personalized presentation instances
  - name: Generation
    description: AI-powered content generation from slide images
  - name: Images
    description: Image upload and management
  - name: Voices
    description: Available TTS voices
  - name: Utility
    description: Health check and diagnostics
  - name: Authentication
    description: Session-based login, logout, and identity
  - name: Company
    description: Organization contact info and knowledge base
  - name: Notifications
    description: Event subscriptions and delivery log
  - name: Contracts
    description: Contract template import and e-signature
  - name: Fonts
    description: Available Google Fonts for branding
  - name: Roof Measurements
    description: Request and track automated roof measurements
  - name: Actions
    description: Voice/text command detection for presentation control
  - name: Appointments
    description: Appointment scheduling for presentation viewers
  - name: Activity
    description: Recent presentation activity feed
  - name: Onboarding
    description: >-
      Per-user product onboarding milestones (ENG-641). Milestone endpoints are
      idempotent and are called by the app UI — they should not be treated as
      tenant-integration surface.
paths:
  /api/decks/{deckId}/slides:
    get:
      tags:
        - Slides
      summary: List slides
      parameters:
        - in: path
          name: deckId
          required: true
          schema:
            type: string
            format: uuid
          description: UUID of the deck
      responses:
        '200':
          description: Ordered list of slides
          content:
            application/json:
              schema:
                type: object
                properties:
                  slides:
                    type: array
                    items:
                      $ref: '#/components/schemas/Slide'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - sessionCookie: []
components:
  schemas:
    Slide:
      type: object
      properties:
        id:
          type: string
          format: uuid
        slideId:
          type: string
        title:
          type: string
        bullets:
          type: array
          items:
            type: string
        narration_script:
          type: string
        slide_context:
          type: string
          nullable: true
        audio_url:
          type: string
          nullable: true
          description: S3 key for the slide audio file
        hero_img:
          type: string
          nullable: true
          description: S3 key for the slide image
        hero_img_thumb:
          type: string
          nullable: true
          description: >-
            Presigned URL for the 480px WebP thumbnail rendition of the hero
            image, sized for editor rails and library grid tiles. Falls back to
            the full image URL when no thumbnail exists (legacy uploads, SVGs,
            and images already at or below 480px). Present on deck read
            endpoints only; omitted from slide create/update responses.
        wordTimings:
          type: array
          items:
            $ref: '#/components/schemas/WordTiming'
          nullable: true
        orderIndex:
          type: integer
        slideType:
          type: string
          enum:
            - standard
            - product_pricing_v1
      required:
        - id
        - slideId
        - title
        - bullets
        - narration_script
        - orderIndex
        - slideType
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    WordTiming:
      type: object
      properties:
        word:
          type: string
        startTime:
          type: number
          description: Start time in milliseconds
        endTime:
          type: number
          description: End time in milliseconds
      required:
        - word
        - startTime
        - endTime
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: cookie
      name: session
      description: Session cookie obtained from `POST /api/auth/login`.

````