# Demosmith Developers

> Create narrated product demo videos from your code or your AI assistant.

- [Demosmith for developers](https://developers.demosmith.ai/index.md): Turn a URL and a sentence into a narrated product demo video, from your code or your AI assistant.
- [Quickstart](https://developers.demosmith.ai/quickstart.md): Create a demo video with one request, then fetch the finished video.
- [Authentication](https://developers.demosmith.ai/authentication.md): API keys for your code, a sign-in for AI assistants, and who in your team can use which.
- [Connect an AI assistant](https://developers.demosmith.ai/assistants.md): Ask Claude, ChatGPT, Claude Code or Cursor to make demo videos for you.
- [Webhooks](https://developers.demosmith.ai/webhooks.md): Get a signed request for each step of a demo, including when the agent needs an answer.
- [When the agent needs an answer](https://developers.demosmith.ai/questions.md): Questions before a demo starts, and logins or codes the agent asks for while it records.
- [Errors and limits](https://developers.demosmith.ai/errors.md): One error shape for every endpoint, the codes you can get, and the rate limits.
- [API reference](https://developers.demosmith.ai/api-reference/introduction.md): Base URL, authentication, and the objects every endpoint returns.
- [Who this key is, and what the plan has left](https://developers.demosmith.ai/api-reference/account/who-this-key-is-and-what-the-plan-has-left.md)
- [Languages, voices, tones, music and resolutions](https://developers.demosmith.ai/api-reference/demos/languages-voices-tones-music-and-resolutions.md)
- [Check a task before creating a demo (free)](https://developers.demosmith.ai/api-reference/demos/check-a-task-before-creating-a-demo-free.md)
- [List demos, newest first](https://developers.demosmith.ai/api-reference/demos/list-demos-newest-first.md)
- [Create and start a demo](https://developers.demosmith.ai/api-reference/demos/create-and-start-a-demo.md): Returns at once. The video takes about 5–20 minutes.
- [Get a demo](https://developers.demosmith.ai/api-reference/demos/get-a-demo.md)
- [Cancel a demo](https://developers.demosmith.ai/api-reference/demos/cancel-a-demo.md)
- [Answer the recorder's question](https://developers.demosmith.ai/api-reference/demos/answer-the-recorders-question.md)
- [List webhook endpoints](https://developers.demosmith.ai/api-reference/webhooks/list-webhook-endpoints.md)
- [Add a webhook endpoint](https://developers.demosmith.ai/api-reference/webhooks/add-a-webhook-endpoint.md)
- [Get a webhook endpoint](https://developers.demosmith.ai/api-reference/webhooks/get-a-webhook-endpoint.md)
- [Delete an endpoint](https://developers.demosmith.ai/api-reference/webhooks/delete-an-endpoint.md)
- [Change, pause or turn on an endpoint](https://developers.demosmith.ai/api-reference/webhooks/change-pause-or-turn-on-an-endpoint.md)
- [Send a signed ping event now](https://developers.demosmith.ai/api-reference/webhooks/send-a-signed-ping-event-now.md)
- [The last 100 deliveries](https://developers.demosmith.ai/api-reference/webhooks/the-last-100-deliveries.md)
- [demo.queued](https://developers.demosmith.ai/api-reference/webhook-events/demoqueued.md): The demo is waiting for a recording slot.
- [demo.started](https://developers.demosmith.ai/api-reference/webhook-events/demostarted.md): Recording started.
- [demo.progress](https://developers.demosmith.ai/api-reference/webhook-events/demoprogress.md): The demo moved to another stage. Opt-in: list it, or subscribe to "*".
- [demo.input_required](https://developers.demosmith.ai/api-reference/webhook-events/demoinput_required.md): The recorder is waiting for an answer — see data.demo.input_request.
- [demo.completed](https://developers.demosmith.ai/api-reference/webhook-events/democompleted.md): The video is ready — data.demo.video has the links.
- [demo.failed](https://developers.demosmith.ai/api-reference/webhook-events/demofailed.md): The demo could not be completed — data.demo.failure.message says why.
- [demo.canceled](https://developers.demosmith.ai/api-reference/webhook-events/democanceled.md): The demo was canceled.

## OpenAPI Specs

- [openapi](/openapi.json)


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