Add missing API endpoints to OpenAPI spec

[mintlify]

Summary

Syncs the OpenAPI spec with all API routes from the initial ai-presentations-demo codebase commit (f954a93). Adds 13 previously undocumented endpoints and updates guide pages.

OpenAPI changes

• Added new tags: Appointments, Roof Measurements, Viewer
• Added endpoints:
  • GET /api/deck_presentations/{id} — load full presentation data for viewer
  • GET/POST /api/presentations/{id}/appointment — appointment scheduling
  • POST /api/presentations/{id}/events-token — refresh event ingest tokens
  • POST /api/roof-measurements — start roof measurement request
  • GET /api/roof-measurements/{id}/status — poll measurement progress
  • POST /api/roof-measurements/{id}/cancel — cancel/skip measurement
  • POST /api/narration/qa-audio — generate Q&A prompt audio
  • POST /api/narration/generate-prompt — fetch resume prompt for playback
  • POST /api/slides/analyze-and-generate — AI image analysis + script generation
  • POST /api/actions — classify viewer input as action or question
  • POST /api/intent/continue — detect continuation intent after Q&A
  • POST /api/decks/{id}/generate-preview — generate preview audio
  • GET /api/decks/{id}/preview-status — check preview audio status

Guide changes

• introduction.mdx: Added appointment scheduling and roof measurements to capabilities list; fixed API reference card link
• narration.mdx: Added section on preview audio for personalized slides
• quickstart.mdx: Fixed broken link to non-existent API reference page

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
demandiq	🟢 Ready	View Preview	Apr 7, 2026, 9:01 PM