@uipath/oms-tool
v1.196.0
Published
CLI plugin for the UiPath Organization Management Service.
Downloads
687
Maintainers
Keywords
Readme
OMS Tool
CLI plugin for the UiPath Organization Management Service (OMS).
Composed under admin-tool. The tool registers its commands directly under uip admin (no wrapper subject group), so users invoke them as uip admin organizations … and uip admin tenants ….
Command tree
uip admin
├── organizations
│ ├── get [--full] # --full → org + tenants + service catalog
│ ├── update [--file <path> | --name | --logical-name | --language]
│ ├── regions
│ │ └── list
│ ├── operation
│ │ └── get <operationId>
│ └── services # org-level services are auto-provisioned with the org
│ ├── list [--service <type>] [--status <status>] [--region <region>]
│ └── list-available
└── tenants
├── list [--filter <fragment>] [--service <type>] [--status <status>] [--environment <env>] [--include-services]
├── get <tenantId>
├── create [--file <path> | --name --region --environment]
├── update <tenantId> [--file <path> | --name | --region | --environment]
├── delete <tenantId> # soft-delete only
├── enable <tenantId>
├── disable <tenantId> [--reason <text>]
└── services
├── list <tenantId> [--service <type>] [--region <region>]
├── list-available --region <Region>
├── add <tenantId> [--file <path> | --service <type>]
├── remove <tenantId> [--file <path> | --service <type>] # soft-remove only
├── enable <tenantId> --service <type>
└── disable <tenantId> --service <type>Subjects
organizations— caller's organization, async operations, and org-level services (with nestedregions list,operation get, andservicesgroups).tenants— tenant lifecycle and tenant-level services (with nestedservicesgroup).
Conventions
- Authenticated via
uip login. - Most mutating commands accept inline flags for common cases and
--file <path>for full-body control. The two paths are mutually exclusive — pick one.tenants services create/deleteare file-only because the body is a single complexservices{}map. - Organizations cannot be created or deleted from the CLI. The CLI deliberately omits
organizations createandorganizations delete— those lifecycle actions go through Portal / the support flow. - Hard-delete is never exposed.
tenants deleteandtenants services removeuse soft semantics; the request body'sisHardDelete(where present) is hard-coded tofalse.tenants services add/removeadditionally validate that every entry in the file body'sservicesmap has the right boolean —trueforadd,falseforremove— to prevent an add-style file from accidentally removing services (or vice versa). - Org-level services are not directly creatable from the CLI. They are auto-provisioned alongside the organization and managed by the platform. The CLI exposes
organizations services listandorganizations services list-availableonly — there is nocreateorupdate-statusfor org services. - Canary tenant routing is never exposed. Where the SDK request DTO accepts
isCanaryTenant, the CLI hard-codes it tofalse. tenants enable/tenants disableuse the v2 variant ofTenant_ChangeTenantStatusto support reason metadata; everything else uses v1.services list-availableis per-region for tenant scope (you must pass--region); for org scope (organizations services list-available) the call usesscope=Accountwith no region.
