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

# API overview

Build LittleDemo workflows from your backend, CLI, or internal tools.

Base URL:

```text
https://littledemo.com
```

Most REST endpoints live under:

```text
https://littledemo.com/api/v1
```

The generated OpenAPI spec is available at:

```text
https://littledemo.com/openapi.json
```

## Common workflow

**Create a project**

```bash
curl -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"}'
```
  **Create a demo**

```bash
curl -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"}'
```
  **Poll or subscribe**

Poll `GET /api/v1/demos/{id}` or use the progress WebSocket at `/api/ws/{demoId}`.
  **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](/api/authentication).