> For the complete documentation index, see [llms.txt](https://docs.twistly.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.twistly.ai/api/asynchronous-flow.md).

# Asynchronous flow

The API is asynchronous. Every `POST` endpoint queues a generation job and returns `202 Accepted` with a job descriptor (`{ id, status, createdAt }`). Poll `GET /v1/presentations/{id}` (recommended cadence: every 2–3 seconds) until `status` becomes `completed` (download URL in `result.url`) or `failed` (reason in `error`).

Typical generation time is 30–90 seconds; the hard cap is 5 minutes per job, after which jobs are marked `failed` with code `TIMEOUT`. Download links are permanent.