> ## 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 workflow-actions execute

> Execute a single workflow action (tool call) outside a full workflow run, streaming its events.

Execute a single workflow action (tool call) outside a full workflow run, streaming its events.

## Usage

```bash theme={null}
modus workflow-actions execute [flags]
```

## Arguments

| Name             |          | Description                                                                                  |
| ---------------- | -------- | -------------------------------------------------------------------------------------------- |
| `workflowAction` | optional | Inline workflowAction descriptor JSON (toolId, toolName, ...). Alternative to --file/--body. |

## Flags

| Flag                | Type    | Description                                                                                                  |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| `--file`            | string  | Path to a JSON file with the workflowAction descriptor.                                                      |
| `--body`            | string  | Read the workflowAction descriptor as JSON from stdin ('-').                                                 |
| `--session-id`      | string  | Client-generated session identifier.                                                                         |
| `--organization-id` | string  | Organization the run belongs to. Omit for PAT/SDK callers — falls back to the authenticated principal's org. |
| `--file-thread-id`  | string  | File thread id for document-scoped execution.                                                                |
| `--automation-id`   | string  | Workflow id for usage attribution.                                                                           |
| `--user-timezone`   | string  | IANA timezone name for the executing user.                                                                   |
| `--run-id`          | string  | Client-supplied run id (Idempotency-Key header wins).                                                        |
| `--source`          | string  | UI surface that triggered this action.                                                                       |
| `--json`            | boolean | Emit structured SSE-derived events instead of raw streamed text.                                             |

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

## Examples

```bash theme={null}
modus workflow-actions execute --session-id sess_1 --file action.json
```

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