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

# POST /api/agent-workflows

> Create a workflow

```text theme={"system"}

POST /api/agent-workflows

```

Creates a workflow draft.

### Body

```json theme={"system"}
{
  "name": "My Intake Flow",
  "description": "...",
  "projectId": "prj_abc",
  "nodes": [...],
  "connections": [...],
  "input_variables": [...],
  "state_variables": [...],
  "settings": {...},
  "status": "draft"
}

```

`lock_version` is initialized to 0. Subsequent updates must provide `lockVersion` to avoid `409 idempotency_conflict`.