docs/elsa/getting-started.md

34 lines
995 B
Markdown
Raw Normal View History

2026-09-25 10:35:26 +00:00
# Getting started
The Elsa workflows engine is already wired into the app — there is nothing to
install. Open the **Elsa Flows** page from the main menu.
## Create a definition
1. On **Elsa Flows**, click **New**.
2. Pick a root template (empty or a starter graph).
3. Give the workflow a name and save.
The definition list on `/flows` shows one row per definition (the latest
version). Use the version filter in the list header to switch between
*Latest*, *Published*, *Draft* and *All versions*.
## Run it
Select a definition and press **Run** in the toolbar. A new run opens on the
**Runs** page (`/flows/runs`), where you can follow the incident list, the
journal and the execution call stack.
<div class="docs-note">
A definition must be <strong>published</strong> before the engine can execute it.
Running a draft returns the engine's <em>published version not found</em> error.
</div>
```json
{
"definitionId": "hello-world",
"version": "1.0.0",
"isPublished": true
}
```