UiPath Documentation
uipath-cli
latest
false
UiPath CLI user guide

uip rules versions

Syntax and options for `uip rules versions`, which lists the versions of a business rule deployed to an Orchestrator folder.

Note:

uip rules versions is labeled Preview in the command help. Refer to Versioning for what the Preview label means.

uip rules versions lists the versions of a business rule deployed to an Orchestrator folder. The active version, marked with IsActive: true, is the one consumers evaluate.

Synopsis​

uip rules versions <rule-name> (--folder-path <path> | --folder-key <key>) [-l <number>] [--offset <number>]
uip rules versions <rule-name> (--folder-path <path> | --folder-key <key>) [-l <number>] [--offset <number>]

Arguments​

NameRequiredPurpose
<rule-name>yesBusiness rule name.

Options​

Pass exactly one of --folder-path or --folder-key.

ShortLongValueDefaultDescription
--folder-pathstring—Folder path, for example Shared.
--folder-keyGUID—Folder key.
-l--limitinteger (1–10000)50Number of versions to return.
--offsetinteger0Number of versions to skip.

Example​

uip rules versions LoanEligibility --folder-path "Shared"
uip rules versions LoanEligibility --folder-path "Shared"

Data shape (--output json)​

{
  "Code": "RulesVersionList",
  "Data": [
    { "Version": "1.0.2", "IsActive": true, "CreationTime": "2026-09-20T08:30:00.000Z" },
    { "Version": "1.0.1", "IsActive": false, "CreationTime": "2026-09-10T14:05:00.000Z" }
  ]
}
{
  "Code": "RulesVersionList",
  "Data": [
    { "Version": "1.0.2", "IsActive": true, "CreationTime": "2026-09-20T08:30:00.000Z" },
    { "Version": "1.0.1", "IsActive": false, "CreationTime": "2026-09-10T14:05:00.000Z" }
  ]
}

The envelope also carries a Pagination object with Returned, Limit, Offset, and HasMore.

Exit codes​

Refer to Exit codes for the shared contract. The command exits 1 in these cases:

ConditionErrorCode
The folder holds no rule with this name.not_found
Neither or both of --folder-path and --folder-key are passed.invalid_argument

See also​

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated