uipath-cli

latest

false

UiPath CLI user guide

Last updated May 7, 2026

uip flow process and uip flow processes

Once a Flow package is published to Orchestrator it becomes a process. This page covers two related command groups:

uip flow process — per-folder operations on a single process definition (list in a folder, get its schema, run it).
uip flow processes (plural) — tenant-wide summaries and per-process incident lookup.

Synopsis

# Singular — per-folder, operational
uip flow process list -f <folder-key> [-t <tenant>] [--filter <odata>] [--login-validity <minutes>]
uip flow process get  <process-key> <feed-id> -f <folder-key> [-t <tenant>] [--login-validity <minutes>]
uip flow process run  <process-key> <folder-key>
                       [-i, --inputs <json>] [-t, --tenant <name>]
                       [--release-key <key>] [--feed-id <id>] [--robot-ids <ids>]
                       [--validate] [--login-validity <minutes>]

# Plural — tenant-wide summary and incident surface
uip flow processes list
uip flow processes incidents <process-key> [--folder-key <key>]
# Singular — per-folder, operational
uip flow process list -f <folder-key> [-t <tenant>] [--filter <odata>] [--login-validity <minutes>]
uip flow process get  <process-key> <feed-id> -f <folder-key> [-t <tenant>] [--login-validity <minutes>]
uip flow process run  <process-key> <folder-key>
                       [-i, --inputs <json>] [-t, --tenant <name>]
                       [--release-key <key>] [--feed-id <id>] [--robot-ids <ids>]
                       [--validate] [--login-validity <minutes>]

# Plural — tenant-wide summary and incident surface
uip flow processes list
uip flow processes incidents <process-key> [--folder-key <key>]

All subcommands require uip login and honor global options. Exit codes follow the standard contract.

uip flow process list

List available Flow processes (releases) in a specific folder.

Options:

Option	Required	Description
`-f, --folder-key <key>`	yes	Folder key (GUID).
`-t, --tenant <name>`	no	Tenant name. Defaults to the authenticated tenant.
`--filter <odata>`	no	Additional OData filter applied server-side.
`--login-validity <minutes>`	no	Token-refresh threshold (default `10`).

Data shape (--output json):

{
  "Code": "FlowProjectList",
  "Data": [
    {
      "name":       "InvoiceFlow",
      "processKey": "a1b2c3d4-0000-0000-0000-000000000001:1.0.0",
      "releaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":  "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":     "default",
      "folderId":   42,
      "active":     "Yes",
      "latest":     "Yes"
    }
  ]
}
{
  "Code": "FlowProjectList",
  "Data": [
    {
      "name":       "InvoiceFlow",
      "processKey": "a1b2c3d4-0000-0000-0000-000000000001:1.0.0",
      "releaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":  "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":     "default",
      "folderId":   42,
      "active":     "Yes",
      "latest":     "Yes"
    }
  ]
}

uip flow process get

Fetch the entry-point schema (input/output JSON schemas) for a Flow process. Use the result to build a valid --inputs payload for process run.

Arguments:

<process-key> (required) — process key, e.g. MyFlow.flow.Flow:1.0.0 or <package-id>:<version>.
<feed-id> (required) — feed ID (from the list output).

Options: -f, --folder-key <key> (required), -t, --tenant, --login-validity.

Data shape:

{
  "Code": "FlowProjectGet",
  "Data": [
    {
      "Path":         "/content/main.flow",
      "DisplayName":  "Main",
      "Type":         "Flow",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}
{
  "Code": "FlowProjectGet",
  "Data": [
    {
      "Path":         "/content/main.flow",
      "DisplayName":  "Main",
      "Type":         "Flow",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema and OutputSchema are re-stringified JSON; parse them as JSON Schema to drive input construction.

uip flow process run

Start a Flow job for a published process.

Arguments:

<process-key> (required) — process key (e.g. MyFlow.flow.Flow:1.0.0).
<folder-key> (required) — folder key (GUID).

Options:

Option	Description
`-i, --inputs <json>`	Inputs as a JSON string or `@path/to/file.json`. If omitted and stdin is piped, stdin is parsed as inputs.
`-t, --tenant <name>`	Tenant name (defaults to authenticated tenant).
`--release-key <key>`	Release key (GUID) — from `process list`.
`--feed-id <id>`	Feed ID for package lookup (optional).
`--robot-ids <ids>`	Comma-separated robot IDs (integers). Invalid values fail fast.
`--validate`	Validate inputs against the process schema before running. Performs basic checks only — required fields present and primitive types match. Complex constraints (enums, patterns, references) are not enforced by this pass.
`--login-validity <minutes>`	Token-refresh threshold (default `10`).

Input precedence: --inputs <json> / --inputs @file.json > stdin > empty object {}.

Examples:

# Run with inline JSON
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-0000-0000-0000-000000000001" \
  --release-key "e5f6a7b8-…" --inputs '{"amount":100}'

# Run with inputs from a file
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" --inputs @inputs.json

# Run with inputs piped from stdin
echo '{"amount":100}' | uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…"

# Validate before running
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" \
  --inputs '{"amount":100}' --validate
# Run with inline JSON
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-0000-0000-0000-000000000001" \
  --release-key "e5f6a7b8-…" --inputs '{"amount":100}'

# Run with inputs from a file
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" --inputs @inputs.json

# Run with inputs piped from stdin
echo '{"amount":100}' | uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…"

# Validate before running
uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" \
  --inputs '{"amount":100}' --validate

Data shape:

{
  "Code": "FlowJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}
{
  "Code": "FlowJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Next step: uip flow job traces <jobKey> to stream execution or uip flow job status <jobKey> to poll.

uip flow processes list

Tenant-wide summary of Flow processes (/processes/summary?processType=Flow). No arguments, no options beyond globals.

Data shape:

{
  "Code": "ProcessList",
  "Data": [
    {
      "processKey":     "…",
      "name":           "…",
      "folderKey":      "…",
      "latestVersion":  "…"
    }
  ]
}
{
  "Code": "ProcessList",
  "Data": [
    {
      "processKey":     "…",
      "name":           "…",
      "folderKey":      "…",
      "latestVersion":  "…"
    }
  ]
}

Note:

The exact field set of each process summary is specified by the Maestro runtime and may evolve; run the command once with --output json against a tenant with data to see the fields you will be consuming, and pin @uipath/cli in CI if you parse specific fields.

uip flow processes incidents

Get all incidents for a specific Flow process definition (not a single instance).

Arguments:

<process-key> (required) — process definition key.

Options:

--folder-key <key> (optional) — folder key to scope the lookup.

Data shape:

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}
{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

See uip flow incidents for the per-incident shape.

Was this page helpful?

PREVIOUSnode / edge

NEXTinstances

UiPath CLI user guide

Synopsis​

uip flow process list​

uip flow process get​

uip flow process run​

uip flow processes list​

uip flow processes incidents​

See also​

Was this page helpful?

Synopsis

uip flow process list

uip flow process get

uip flow process run

uip flow processes list

uip flow processes incidents

See also