# workflows

> Reference for the workflows tool: create, read, list and update workflows of connected prompt steps.

Source: https://prompt-verse.io/docs/reference/workflows/

A workflow is a list of nodes. Input nodes take text; prompt nodes run one of your prompts on what came before.

Call it as `geenius_promptverse(tool: "workflows", action: "<action>", args: {...})` through Geenius OS, or as the `workflows` tool of the Prompt Verse MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `create` | An empty workflow. |
| `get` | One workflow with its nodes. |
| `list` | Newest first. |
| `update` | Replace the title and, or, the whole node list. |
| `run` | Run every node in order. The input seeds the input nodes. Switched off in the pre-beta. |

## Arguments we have checked

### workflows · create

An empty workflow.

- `title` (required): Name.

### workflows · get

One workflow with its nodes.

- `id` (required): Workflow id.

### workflows · update

Replace the title and, or, the whole node list.

- `id` (required): Workflow id.
- `title`: New name.
- `data`: An object with a nodes list.

### workflows · run

Run every node in order. The input seeds the input nodes. Switched off in the pre-beta.

- `id` (required): Workflow id.
- `input`: Optional input text.
- `model_id`: Optional model id.

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "create"`. The server answers from its own definitions, so that answer is always current.

> [!HONEST]
> run is listed but refuses while the AI features are off.

