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

# Create render

> Queue a render. Returns a job handle; poll get-render.

<ParamField path="id" type="string" required>Workflow id.</ParamField>

### Body

<ParamField body="options" type="object">Renderer opts: resolution, quality, audio mode override.</ParamField>

Supports `Idempotency-Key`.

### Response

```json theme={null}
{
  "job_id":   "job_lq3z9m_8fa1c0",
  "status":   "queued",
  "simple":   true,
  "poll_url": "/v1/workflows/wf_xyz/renders/job_lq3z9m_8fa1c0"
}
```

`status` is one of:

| Status          | What it means                                        |
| --------------- | ---------------------------------------------------- |
| `queued`        | Server will pick it up shortly.                      |
| `running`       | Render in progress; check `progress` (0..1).         |
| `needs_browser` | Complex workflow; canvas will pick up on next visit. |
| `done`          | `result.video_url` is populated.                     |
| `failed`        | `error` is populated.                                |

<Note>
  "Simple" = one shot, no audio tracks, no captions, no audio mixing.
  Simple renders run end-to-end on our infrastructure. Complex
  workflows are flagged `needs_browser` until the platform's
  full-fidelity render path picks them up.
</Note>