API overview
Build LittleDemo workflows from your backend, CLI, or internal tools.
API overview
Base URL:
texthttps://littledemo.com
Most REST endpoints live under:
texthttps://littledemo.com/api/v1
The generated OpenAPI spec is available at:
texthttps://littledemo.com/openapi.json
Common workflow
1
Create a project
bashcurl -X POST https://littledemo.com/api/v1/projects \ -H "Authorization: Bearer ld_live_xxx" \ -H "Content-Type: application/json" \ -d '{"name":"Acme App","url":"https://app.acme.com","viewport":"desktop"}'
2
Create a demo
bashcurl -X POST https://littledemo.com/api/v1/demos \ -H "Authorization: Bearer ld_live_xxx" \ -H "Content-Type: application/json" \ -d '{"project_id":"proj_abc123","prompt":"Show onboarding"}'
3
Poll or subscribe
Poll GET /api/v1/demos/{id} or use the progress WebSocket at /api/ws/{demoId}.
4
Embed
Use https://littledemo.com/embed/{demoId} in an iframe.
Authentication
Use Authorization: Bearer ld_live_xxx for server-side API calls. Dynamic embeds can use publishable keys with X-API-Key.
See API authentication.