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

# Demosmith for developers

> Turn a URL and a sentence into a narrated product demo video, from your code or your AI assistant.

Send Demosmith a URL and a task in plain words. An agent opens a real browser, records the walkthrough, and the video is edited, narrated and rendered for you. About 5 to 20 minutes later you get a link to the finished video.

> [card] [Quickstart](https://developers.demosmith.ai/quickstart.md)
>
> Create your first demo with one API call.

> [card] [Connect an AI assistant](https://developers.demosmith.ai/assistants.md)
>
> Make demos from Claude, ChatGPT, Claude Code or Cursor.

> [card] [Webhooks](https://developers.demosmith.ai/webhooks.md)
>
> Hear about every step, including when the agent needs an answer.

> [card] [API reference](https://developers.demosmith.ai/api-reference/introduction.md)
>
> Every endpoint, with a playground.

## How a demo runs

**1. Check the task (optional, free)**

`POST /demos/check` reads your task and asks a question when something is unclear. It creates nothing and uses no minutes.

**2. Create the demo**

`POST /demos` starts the demo and answers at once with `status: "queued"`.

**3. Follow it**

Get a [webhook](https://developers.demosmith.ai/webhooks.md) for each step, or poll `GET /demos/{id}`. If the agent reaches a sign-in page, the demo waits for [an answer](https://developers.demosmith.ai/questions.md).

**4. Get the video**

When `status` is `completed`, `video.url` plays the video and `video.download_url` downloads the MP4.

## Plans and minutes

The API and the assistant connection are part of every paid plan. Demos made here use the same minutes as demos made in the app, and they appear in your demo library like any other.

> [!NOTE]
>
> Free plans and the free trial can't use the API. You can see what you'd get on the **Developers** page in the app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.