> ## 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.

# Backgrounds API

List built-in backgrounds and upload custom backgrounds.

Presentation backgrounds can be built in or uploaded.

## List backgrounds

```bash
curl https://littledemo.com/api/v1/backgrounds \
  -H "Authorization: Bearer ld_live_xxx"
```

## Upload a custom background

```bash
curl -X POST https://littledemo.com/api/v1/backgrounds/upload \
  -H "Authorization: Bearer ld_live_xxx" \
  -F "file=@background.webp"
```

Supported image formats include PNG, JPEG, and WebP.

## Serve a custom background

Uploaded backgrounds return a URL that can be used in presentation settings.

```text
GET /api/v1/backgrounds/custom/{key}
```