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

# Build with AskEditor

> The video editing API for AI agents. Raw footage in, a finished edit out: plus an editable timeline, every time.

AskEditor turns raw video into finished, directed edits through one API.
An agent (or your code) names a **template**, hands over **material**, and
gets back a finished edit. What "finished" means is stated on every template
as its **`delivery`**:

* **`delivery: "file"`** — an **mp4** at `finalUrl`, plus **`canvasUrl`**: the
  same edit as an **editable timeline** in the AskEditor editor. Not a
  screenshot of the result: the layers, trims, animations and audio, live and
  adjustable.
* **`delivery: "canvas"`** — the **editable timeline is the deliverable**, and
  there is no mp4. These templates sell an arrangement rather than pixels —
  which word, when, in what layer order — and it stays adjustable. Export it
  yourself when you want a file.

No other video API returns the second one, and the `canvas` templates exist
*because* of it. [How delivery works](https://askeditor.com/docs/concepts/the-editable-canvas.md).

## Start here

> [card] [Quickstart for agents (MCP)](https://askeditor.com/docs/quickstart/agents.md)
>
> Connect Claude, ChatGPT, Cursor or any MCP client, and your agent edits
> your AskEditor projects from the chat. Most integrations start here.

> [card] [Quickstart (REST)](https://askeditor.com/docs/quickstart/rest.md)
>
> Key → upload → run → poll, in curl, JavaScript, or Python.

> [card] [Templates](https://askeditor.com/docs/templates/overview.md)
>
> The catalog. Each template is a finished edit with a typed input
> contract: what to record, the knobs, the price, the ETA.

> [card] [The editable canvas](https://askeditor.com/docs/concepts/the-editable-canvas.md)
>
> Why every response carries a timeline, and what your users can do
> with it.

## The shape of every call

```bash theme={null}
POST /v1/run/{template_id}    # material + spec  → job_id
GET  /v1/jobs/{job_id}        # queued → running → { finalUrl?, canvasUrl }
                              # finalUrl only when delivery is "file"
```

Templates are addresses, not endpoints: the API surface never grows as the
catalog does. List them at [`GET /v1/templates`](https://askeditor.com/docs/api-reference/overview).


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