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

# Refreshing demos

How refreshes keep demos current without changing embed code.

A refresh records the demo again. The embed URL stays the same, and the latest ready version is served automatically.

Use refreshes when the product UI changed, the copy changed, or a demo environment now has better data.

Refresh applies to demos generated by LittleDemo. Uploaded local recordings cannot be refreshed in place; re-record locally and upload a replacement when that source video changes.

## Refresh methods

| Method | Best for |
| --- | --- |
| Manual refresh | One-off fixes from the dashboard. |
| Scheduled refresh | Demos that should stay current without deploy hooks. |
| Webhook refresh | CI/CD pipelines that know exactly when a deploy finished. |
| API refresh | Product-owned workflows and internal tools. |

## Refresh one demo

```bash
curl -X POST https://littledemo.com/api/v1/demos/demo_abc123/refresh \
  -H "Authorization: Bearer ld_live_xxx"
```

## Refresh a project

```bash
curl -X POST https://littledemo.com/api/v1/projects/proj_abc123/refresh \
  -H "Authorization: Bearer ld_live_xxx"
```

## Refresh after deploy

```bash
curl -X POST https://littledemo.com/api/v1/webhooks/projects/proj_abc123/refresh \
  -H "X-Webhook-Secret: whsec_xxx"
```

The webhook endpoint queues refresh jobs for ready generated demos in the project. Uploaded demos are skipped.