Manage workflows
frontline workflows [options] [command]List all workflows (JSON by default; use --pretty/--table for human-readable output)
frontline workflows list [options]Options
| Flag | Description | Default |
|---|---|---|
--status <status> | Filter by status (e.g. active, inactive, draft) | |
--pretty | Pretty human-readable output | |
--table | Render as table | |
--json | Output raw JSON (default behavior — accepted as a no-op) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |
Create a workflow automation and select it as the active workflow
frontline workflows create [options]Options
| Flag | Description | Default |
|---|---|---|
--name <name> | Workflow name | |
--description <description> | Workflow description | |
--no-use | Do not set the created workflow as active | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Select the active workflow for commands that omit --workflow-id
frontline workflows use [options] <workflowId>Options
| Flag | Description | Default |
|---|---|---|
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Describe a workflow. Uses the active workflow unless --workflow-id is passed
frontline workflows describe [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--include-nodes | Include workflow nodes | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Update workflow metadata or status
frontline workflows update [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--name <name> | Workflow name | |
--description <description> | Workflow description | |
--status <status> | Workflow status (ACTIVE, DRAFT, DELETED) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Delete the active workflow or the workflow passed with --workflow-id
frontline workflows delete [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Manually run the active workflow (or --workflow-id). Only available for ACTIVE scheduled workflows
frontline workflows run [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Get the graph for the active workflow or --workflow-id
frontline workflows graph [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Manage workflow nodes
frontline workflows nodes [options] [command]List nodes for the active workflow or --workflow-id
frontline workflows nodes list [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Create a node in the active workflow or --workflow-id
frontline workflows nodes create [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--data <json> | Node JSON payload, inline | |
--file <path> | Node JSON payload file; use - for stdin | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Update a node in the active workflow or --workflow-id
frontline workflows nodes update [options] <nodeId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--data <json> | Partial node JSON payload, inline | |
--file <path> | Partial node JSON payload file; use - for stdin | |
--replace | Send --data/--file as-is instead of merging data with the node's current config. Without this flag, a partial data (e.g. only { personSource }) is merged onto the existing node data client-side before sending, so unspecified fields are kept. | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Delete a node and its connected edges
frontline workflows nodes delete [options] <nodeId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Manage workflow edges
frontline workflows edges [options] [command]Add or replace the outgoing edge for a node
frontline workflows edges add [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--source <nodeId> | Source node ID | |
--source-handle <handleId> | Source handle ID | |
--target <nodeId> | Target node ID | |
--target-handle <handleId> | Target handle ID | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Remove an edge
frontline workflows edges remove [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--source <nodeId> | Source node ID | |
--source-handle <handleId> | Source handle ID | |
--target <nodeId> | Target node ID | |
--target-handle <handleId> | Target handle ID | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Manage variables for the active workflow
frontline workflows variables [options] [command]Options
| Flag | Description | Default |
|---|---|---|
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
List workflow variables
frontline workflows variables list [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--filter-text <text> | Filter by name or description | |
| `--is-default <true | false>` | Filter default variables |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
List all workflow variables including defaults
frontline workflows variables all [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Create a workflow variable
frontline workflows variables create [options]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--name <name> | Variable name | |
--description <description> | Variable description | |
--pattern <pattern> | Optional validation pattern | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Describe a workflow variable
frontline workflows variables describe [options] <variableId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Update a workflow variable
frontline workflows variables update [options] <variableId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--name <name> | Variable name | |
--description <description> | Variable description | |
--pattern <pattern> | Optional validation pattern | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Delete a workflow variable
frontline workflows variables delete [options] <variableId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Check whether a workflow variable name exists
frontline workflows variables check-name [options] <name>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug info on stderr (token is redacted) | |
--pretty | Pretty-print human-readable output (instead of default JSON) | |
--table | Render list results as a table (implies --pretty) | |
--json | Output raw JSON (default behavior — accepted as a no-op) |
Get analytics for a workflow. Uses the active workflow unless an ID is passed
frontline workflows analytics [options] [workflowId]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--start-date <date> | Start date (YYYY-MM-DD) | |
--end-date <date> | End date (YYYY-MM-DD) | |
--pretty | Pretty human-readable output | |
--table | Render as table | |
--json | Output raw JSON (default behavior — accepted as a no-op) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |
List a workflow's run logs. Uses the active workflow unless an ID is passed
frontline workflows logs [options] [command] [workflowId]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--status <status> | Filter by run status (e.g. SUCCESS, FAILED, RUNNING) | |
--start-date <date> | Start date (YYYY-MM-DD) | |
--end-date <date> | End date (YYYY-MM-DD) | |
--page <n> | Page number | |
--page-size <n> | Page size | |
--pretty | Pretty human-readable output | |
--table | Render as table | |
--json | Output raw JSON (default behavior — accepted as a no-op) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |
List a workflow's run logs (same as bare 'workflows logs')
frontline workflows logs list [options] [workflowId]Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--status <status> | Filter by run status (e.g. SUCCESS, FAILED, RUNNING) | |
--start-date <date> | Start date (YYYY-MM-DD) | |
--end-date <date> | End date (YYYY-MM-DD) | |
--page <n> | Page number | |
--page-size <n> | Page size | |
--pretty | Pretty human-readable output | |
--table | Render as table | |
--json | Output raw JSON (default behavior — accepted as a no-op) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |
Get a single workflow run log with its per-node results
frontline workflows logs get [options] <logId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--pretty | Pretty human-readable output | |
--table | Render as table | |
--json | Output raw JSON (default behavior — accepted as a no-op) | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |
Get a single node's full execution trace (audit log) within a run
frontline workflows logs trace [options] <logId> <nodeResultId>Options
| Flag | Description | Default |
|---|---|---|
--workflow-id <id> | Workflow ID. Defaults to the active workflow | |
--pretty | Pretty human-readable output | |
--api-key <key> | Override API key for this run (else FRONTLINE_API_KEY env, else stored profile key) | |
--base-url <url> | Advanced: override Public API base URL for this run | |
--profile <name> | Credentials profile: uses that profile's saved API key and Public API base URL (see frontline auth profiles list) | |
--debug | Show debug information (redacted token) |