API Reference

The SlideForge API is a REST API that generates consulting-quality PowerPoint slides.

Base URL

https://api.slideforge.dev

Authentication

All requests require a Bearer token in the Authorization header. Get your API key from the Console.

Authorization: Bearer sf_live_YOUR_KEY

Response Format

All responses are JSON. POST /v1/render with structured params returns 200 OK synchronously with the result — no polling needed. All other generation endpoints return 202 Accepted with a job_id for async polling. Errors return appropriate HTTP status codes with a detail message.

Endpoints

POST/v1/renderRender from template — sync (params) or async (brief)POST/v1/render/specRender from declarative Flexbox + component spec POST/v1/render/preflightValidate template + params without rendering (free)POST/v1/suggest-layoutLLM generates a render/spec-compatible JSON spec POST/v1/generateAI-designed slide from a natural language brief POST/v1/iterateImprove a slide with feedback POST/v1/deckGenerate a multi-slide deck PATCH/v1/deck/{id}Update deck — swap slides or change metadata POST/v1/deck/from-jobsAssemble deck from existing slide jobs (free)POST/v1/deck/{id}/forkFork a deck for A/B variants (free)POST/v1/workflows/consulting-deckOne call → consulting deck with narrative structure POST/v1/translateTranslate a PPTX preserving formatting ($0.02/slide)POST/v1/translate/from-jobTranslate from a previous generation job GET/v1/jobsList your recent jobs GET/v1/jobs/{id}Get job status and results (supports long-poll)GET/v1/jobs/{id}/versionsGet iteration history for a slide DELETE/v1/jobs/{id}Delete a job and its files GET/v1/templatesList all 50 templates POST/v1/templates/suggestFind best template for a brief POST/v1/templates/searchSemantic template search GET/v1/componentsList all 24 design system components GET/v1/themesList available themes POST/v1/themesSave a custom theme POST/v1/themes/uploadExtract theme from a .pptx file GET/v1/files/{path}Download files via signed URL