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

# modus workflows create

> Create a workflow. Nested fields (trigger, agentSelection, workflowStructure) require --file/--body — see --example.

Create a workflow. Nested fields (trigger, agentSelection, workflowStructure) require --file/--body — see --example.

## Usage

```bash theme={null}
modus workflows create [flags]
```

## Flags

| Flag            | Type    | Description                                         |
| --------------- | ------- | --------------------------------------------------- |
| `--example`     | boolean | Print an example workflow JSON to stdout and exit.  |
| `--file`        | string  | Path to a JSON file with the full create body.      |
| `--body`        | string  | Read the full create body as JSON from stdin ('-'). |
| `--name`        | string  | Workflow display name.                              |
| `--type`        | string  | Workflow type. (default: `workflow`)                |
| `--description` | string  | One-paragraph description.                          |
| `--guardrail`   | string  | Guardrail id (repeatable).                          |

Global: `--pretty` — human-readable table output instead of compact JSON.

## Examples

```bash theme={null}
modus workflows create --example > workflow.json
modus workflows create --file workflow.json
```

See [CLI quickstart](/guides/cli) for install and auth.