Loading...
Loading...
UiPath Admin via `uip admin` — Identity Server (users, groups, robot accounts, external OAuth2 apps, secrets), Authorization (custom roles, role assignments, permission catalog, effective-access via check-access PDP), OMS (org read/update, tenant lifecycle, service provisioning, regions, async operation polling), IP Restriction (allowlist, enforcement switch, bypass rules, lockout safety), Audit via `uip admin audit` — the organization/tenant audit trail: event sources, paginated event queries, day-wise-JSON-folder or single-CSV exports. Troubleshoot: diagnose access-denied, investigate login failures, role misconfiguration, IP lockout, PAT/app auth issues. This skill owns ALL org/tenant/identity audit — use `uip admin audit` (NOT `uip or audit-logs`) for any audit logs / audit trail / audit events / export / login history / who-did-what request. For Orchestrator-specific roles/permissions/folders/jobs→uipath-platform. For RPA workflows→uipath-rpa.
npx skill4agent add uipath/skills uipath-adminuip adminOrganizationTenantGlobalTenantProjectOrganizationTenantTenantGlobalProjectFolderAppuip admin organizationsservices listlist-availableaddenabledisableremovetenantsoperationIdorganizations operation get <id>tenants createip-restriction my-ipSurface boundary — this is, notuip admin audit. Every org/tenant audit ask below — including bare "audit logs", "audit history", "export the audit trail", "login history", "who did what" — is served byuip or audit-logs. Do not fall back touip admin audit <scope>(Orchestrator-operational audit, a different schema; that's theuip or audit-logsskill), even when the user's wording is generic. When the user asks what audit events / sources are available or visible, answer by runninguipath-platform— discover live, never describe from memory or the docs.uip admin audit <scope> sources
uip admin audit--file-format csvScope routing (which phrasing →vsorg, and why) lives in audit-workflow-guide.md → Audit scope disambiguation. Critical Rule 23 governs the stop-and-ask requirement when scope is ambiguous.tenant
Structured diagnose capability index with failure-mode lookup and diagnostic priority ladder: diagnose/CAPABILITY.md. Quick investigation playbooks: identity-troubleshoot-guide.md.
uip or rolesuipath-platformuip admin authorizationuip admin audit <scope>sourceseventsexportuip or audit-logsuip or audit-logsComponent,User,Action,Operation,Time--exportuipath-platformuip or audit-logsuip admin audituip login status --output jsonuip login--output jsonuip loginroles assignments create/deleteusers deletegroups deletegroups members add/revokerobot-accounts deleteexternal-apps deleteexternal-apps generate-secretPrincipal: <displayName> (<userName>) — <id>listcreateusers invitegenerate-secret--app-scope--user-scope--app-scope "OR.Folders"users listgroups members add/revokeCustomroles createroles update--file ./actions.jsonroles get--service--service studioTenant--service appsOrganization--scopeserviceName--serviceroles list --service <svc>roles assignments list --service <svc>check-accessroles create --scopeOrganization|TenantGlobal|Tenant|Projectroles assignments create --scopeFolder|Approles assignments list --scopeTenantGlobalcheck-access --scopeTenant|Folderroles assignments create/delete--identity-idroles assignments createownerServiceNameCentralizedAccess//tenant/<tid>lowercase(ownerServiceName)Reinfertenants create/update/delete/enable/disableoperationIdorganizations operation get <OP_ID>organizations createorganizations deletetenants delete<TENANT_ID>tenants deletetenants disabletenants services remove--regiontenants createorganizations regions listservices disableremoveorgtenanttenantuip admin audit org sourcesuip admin audit tenant events--scopeaudit sources --scope organizationaudit <scope> events{auditEvents, next, previous}Data[0]Data.auditEvents[]nextpreviousprevious--limit--from-date--to-datemaxCount[10, 200]ceil(N/200)--limit 500--limit[1, 10000]Result: "ValidationError"--limitaudit <scope> sourcesevents --source / --target / --typeaudit <scope> sourcesaudit <scope> events--from-date--to-date2026-04-012026-04-01T14:30:00Z--to-dateT23:59:59.999Zeventsexportdate -u--searchcreatedOneventDetails--tenant-idorgaudit org eventsaudit tenantAudit.Readuip logout && uip loginErrorCode: server_errorRetry: RetryLaterHTTP 503: no healthy upstreamHTTP 504--limit{"Result":"Failure",...}audit <scope> export--output-path--from-date--to-date--output-path--from-date 2026-01-01 --to-date 2026-01-31--from-date X --to-date Xevents--to-date--output-pathaudit_<from>_<to>_<generated-at>json.csvcsv--file-format <json|csv>json<YYYY-MM-DD>.jsoncsvcsvjson--output-path./audit-exportsPathGeneratedAtenforcement enableip-restriction my-ipip-ranges listip-ranges list--confirmip-ranges delete--confirmenforcement disabletype: "BuiltIn"groups members add <GROUP_ID> --user-ids ...--group-id <GROUP_ID>getupdatedeletecreateevents{auditEvents, next, previous}--from-date--to-date--limittenantorgsourcesevents--tenant-idorgAudit.Readuip logout && uip login{"Result":"Failure"|"ValidationError", ...}ValidationErrorroles updatescopeTypeownerServiceNameservices listservices list-available--to-dateexportevents| Goal | Entry command(s) |
|---|---|
| Invite a user → assign to group | user-management.md + group-management.md |
| Create a custom role | |
| Grant permission(s) to a principal ("grant me X", "give alice Y, Z") | grant-permissions.md — intersection-and-menu flow |
| Assign a role to a principal | (1) Resolve principal per Rule 5. (2) |
| See what a principal can do | |
| Create a tenant | tenant-management.md — region + default-services resolution, file-body shape, operation polling (Rule 18) |
| Add a tenant service | |
| Look up my public IP ("what's my IP?", "what public IP does the platform see for me?") | |
| Enable IP allowlist enforcement | |
| Query audit events / export | audit-workflow-guide.md — scope disambiguation + 4 investigation playbooks (who-did-X, login history, date-range dump, overview) |
Organization (org)
└── Partition (= org in most cases)
├── Users ← human identities
├── Groups ← role containers (BuiltIn + Custom)
├── Robot Accounts ← unattended automation identities
└── External Apps ← OAuth2 clients (Client ID + Secret)| Concept | Purpose | Managed by |
|---|---|---|
| Robot account | Identity — who the robot is | Identity Server ( |
| Robot credentials | Per-robot Client ID + Secret for machine auth | Orchestrator (machine connection) |
| External app | OAuth2 client for API integrations, CI/CD | Identity Server ( |
| Area | Always surface |
|---|---|
| Identity mutations | Result + new resource id; for external-app create / |
| Authz reads + mutations | Provenance: role name, |
| OMS reads | Separate provisioned (with status) from available catalog (no status). Lead with |
| OMS mutations | Echo the resolved target before running (Anti-pattern 13). Async: auto-poll 3× at 5 s, then numbered menu (Rule 18). Sync services: re-list to verify post-state (Rule 22). |
| Audit queries | Disambiguate |
| IP Restriction mutations | Before |
| I need to... | Read first |
|---|---|
| Identity CLI reference | references/identity-commands.md |
| Manage users (list / create / invite / update / delete) | references/user-management.md |
| Manage groups (CRUD + membership) | references/group-management.md |
| Manage robot accounts | references/robot-account-management.md |
| Manage external apps (OAuth2 + secrets + federated credentials) | references/external-app-management.md |
| Manage personal access tokens (PATs) | references/pat-management.md |
| Configure SMTP email settings | references/smtp-management.md |
| Authorization CLI reference | references/authorization/authorization-commands.md |
| Manage custom roles | references/authorization/role-management.md |
| Grant permission(s) to a principal — scope/service intersection flow | references/authorization/grant-permissions.md |
| Manage role assignments (incl. role-service vs scope-path validation, Rule 17) | references/authorization/role-assignment-management.md |
| List permission definitions | references/authorization/permission-catalog.md |
| Check effective access for a principal | references/authorization/check-access.md |
| Organizations CLI reference | references/organizations-commands.md |
| Tenants CLI reference | references/tenants-commands.md |
| Manage the organization (read + update, polling, regions, org services read-only) | references/organization-management.md |
| Manage tenants (CRUD, enable/disable, tenant services) | references/tenant-management.md |
| IP-restriction CLI reference | references/ip-restriction/ip-restriction-commands.md |
| Manage IP allowlist entries | references/ip-restriction/ip-range-management.md |
Toggle enforcement (+ | references/ip-restriction/enforcement-management.md |
| Manage bypass rules | references/ip-restriction/bypass-rule-management.md |
| Audit CLI reference | references/audit-commands.md |
| Audit investigation workflows (scope disambiguation, who-did-X, login history, date-range dump, overview) | references/audit-workflow-guide.md |
| Paginate audit events beyond 200 | references/audit-commands.md + Rule 25 |
| Troubleshoot access denied, login failures, role misconfig, IP lockout, PAT/app auth | references/identity-troubleshoot-guide.md |
| Diagnose capability index (structured) | references/diagnose/CAPABILITY.md |
| Failure mode lookup (12 named patterns) | references/diagnose/references/failure-modes.md |
| Diagnostic priority ladder (sequential triage) | references/diagnose/references/troubleshooting-guide.md |