@uipath/skills 1.195.0 → 1.196.0

package/skills/uipath-platform/references/orchestrator/tenant-admin.md

@@ -17,7 +17,7 @@ Configure tenant settings, manage calendars for scheduling, export audit logs, a
 
 ## Prerequisites
 
-- Authenticated (`uip login`)
+- Authenticated — verify with `uip login status`; if not logged in, ask the user to run `uip login` (it opens an interactive browser flow)
 - Tenant selected (`uip login tenant set "<tenant>"`)
 - Appropriate admin permissions (Settings and Audit Logs require tenant admin; other commands vary by role)
 
@@ -29,11 +29,11 @@ Tenant settings are dot-notation key-value pairs that control tenant behavior. U
 
 | Command | What it does |
 |---------|--------------|
-| `uip or settings list` | List all settings. Filter with `--scope Application\|Tenant\|User\|All`. |
+| `uip or settings list` | List all settings as curated `{Name, Value, Scope}` rows. Filter with `--scope Application\|Tenant\|User\|All`; `--all-fields` for the raw DTO. |
 | `uip or settings get <key>` | Get a single setting value by key. |
 | `uip or settings update <key> <value>` | Update a setting value. |
 | `uip or settings execution` | Get execution settings with display names, types, and allowed values. Use `--scope 0` (Global) or `--scope 1` (Robot). |
-| `uip or settings timezones` | List all valid timezone IDs (for use with `Abp.Timing.TimeZone`). |
+| `uip or settings timezones` | List all valid timezone IDs as `{Name, Value}` rows — pass the `Value` to `Abp.Timing.TimeZone`. |
 
 **Common setting keys:**
 
@@ -80,7 +80,7 @@ uip or calendars create "US Holidays" --time-zone "America/New_York" --output js
 # Save the returned Key (GUID)
 
 # Use the calendar key when creating a time trigger
-uip resource triggers create --type time --name "WeekdayReport" \
+uip or triggers create --type time --name "WeekdayReport" \
   --release-key <process-key> --cron "0 9 * * 1-5" \
   --calendar-key <calendar-key> --time-zone "America/New_York" \
   --runtime-type Unattended --job-priority Normal \
@@ -158,7 +158,7 @@ uip or feeds list --output json
 Feed IDs are used with:
 - `uip or packages list --feed-id <id>` -- browse packages in a specific feed
 - Omit `--feed-id` to use the default tenant feed
-- `uip resource libraries list` does NOT accept `--feed-id` -- it always queries the default tenant feed. Filter results client-side via `--output-filter "<JMESPath>"`.
+- `uip or libraries list` does NOT accept `--feed-id` -- it always queries the default tenant feed. Filter results client-side via `--output-filter "<JMESPath>"`.
 
 ---
 
@@ -213,7 +213,7 @@ uip or attachments download "<attachment-id>" -o error-screenshot.png
 - **Calendar timezone affects trigger scheduling.** A trigger using a calendar will skip dates according to the calendar's timezone, which may differ from the trigger's own timezone. Keep them aligned.
 - **Audit log export is async.** The `--export` flag triggers a server-side export job. The CLI polls until the CSV is ready, then downloads it. Large exports may take a few seconds.
 - **Credential store keys are numeric**, not GUIDs. This is an exception to the usual GUID convention in the Orchestrator CLI.
-- **Feed IDs apply to `packages` only.** `uip or packages` commands accept `--feed-id` for multi-feed tenants; `uip resource libraries` commands do NOT — they always target the default tenant feed.
+- **Feed IDs apply to `packages` only.** `uip or packages` commands accept `--feed-id` for multi-feed tenants; `uip or libraries` commands do NOT — they always target the default tenant feed.
 - **Attachments are tenant-scoped.** You do not need `--folder-path` or `--folder-key` -- the `list` command resolves the folder from the job key automatically.
 
 ---
@@ -221,5 +221,5 @@ uip or attachments download "<attachment-id>" -o error-screenshot.png
 ## Related
 
 - [setup-environment.md](setup-environment.md) -- Credential stores are used during unattended user setup.
-- Triggers & Webhooks (calendars are referenced by `--calendar-key` when creating time triggers) → [`uipath-resources`](../resources/triggers-and-webhooks.md)
+- Triggers & Webhooks (calendars are referenced by `--calendar-key` when creating time triggers) → [triggers-and-webhooks.md](triggers-and-webhooks.md)
 - [orchestrator.md](orchestrator.md) -- Parent reference with common flags and pagination patterns.

package/skills/uipath-platform/references/{resources → orchestrator}/triggers-and-webhooks.md

@@ -2,7 +2,7 @@
 
 Automate job execution with time, queue, and API triggers, and set up webhooks for external event notifications.
 
-> For full option details on any command, use `--help` (e.g., `uip resource triggers create --help`).
+> For full option details on any command, use `--help` (e.g., `uip or triggers create --help`).
 
 ## When to Use
 
@@ -13,8 +13,8 @@ Automate job execution with time, queue, and API triggers, and set up webhooks f
 
 ## Prerequisites
 
-- Authenticated (`uip login`)
-- Target folder exists with machines assigned (see [setup-environment.md](../orchestrator/setup-environment.md))
+- Authenticated — verify with `uip login status`; if not logged in, ask the user to run `uip login` (it opens an interactive browser flow)
+- Target folder exists with machines assigned (see [setup-environment.md](setup-environment.md))
 - Process (release) created -- you need the release key from `uip or processes list`
 
 ---
@@ -55,7 +55,7 @@ uip or processes list --folder-path "Finance" --output json
 ### Time Trigger
 
 ```bash
-uip resource triggers create --type time \
+uip or triggers create --type time \
   --name "WeekdayInvoiceRun" \
   --release-key <process-key> \
   --cron "0 0 9 ? * MON-FRI" \
@@ -84,9 +84,9 @@ Additional options:
 ### Queue Trigger
 
 ```bash
-uip resource queues list --folder-path "Finance" --output json  # get queue key
+uip or queues list --folder-path "Finance" --output json  # get queue key
 
-uip resource triggers create --type queue \
+uip or triggers create --type queue \
   --name "InvoiceQueueTrigger" \
   --release-key <process-key> \
   --queue-key <queue-key> \
@@ -99,7 +99,7 @@ Additional options: `--items-per-job` (default 1), `--activate-on-complete` (re-
 ### API Trigger
 
 ```bash
-uip resource triggers create --type api \
+uip or triggers create --type api \
   --name "InvoiceEndpoint" \
   --release-key <process-key> \
   --slug "process-invoice" \
@@ -117,22 +117,24 @@ CallingMode values: `AsyncRequestReply`, `AsyncCallback`, `LongPolling`, `FireAn
 
 ```bash
 # List time triggers in a folder
-uip resource triggers list --type time --folder-path "Finance" --output json
+uip or triggers list --type time --folder-path "Finance" --output json
 
 # Filter: only enabled, by name
-uip resource triggers list --type queue --folder-path "Finance" --enabled --name "Invoice" --output json
+uip or triggers list --type queue --folder-path "Finance" --enabled --name "Invoice" --output json
 
 # Get details
-uip resource triggers get <trigger-key> --type time --folder-path "Finance" --output json
+uip or triggers get <trigger-key> --type time --folder-path "Finance" --output json
 
 # Update (only provided fields change)
-uip resource triggers update <trigger-key> --type time \
+uip or triggers update <trigger-key> --type time \
   --cron "0 30 8 ? * MON-FRI" --folder-path "Finance" --output json
 ```
 
 > **`--type` matters on get/update/delete.** Default is `time`. If you pass an api or queue trigger key without `--type api` / `--type queue`, the command hits ProcessSchedules and returns `HTTP 404: ProcessSchedule does not exist.` The error instructions surface a hint pointing at the right `--type` — re-run with the correct one. (`triggers list` shows the type per entry.)
 
-> **Enum flag values are case-insensitive.** `--method POST`, `--runtime-type SERVERLESS`, `--job-priority HIGH` all work and are normalized to canonical PascalCase before the API call. Same on `queue-items` (`--priority high` ≡ `High`) and `processes edit` (`--retention-action delete`, `--robot-size standard`).
+> **`--type` filters the list.** `triggers list --type time` returns only time triggers, `--type queue` only queue triggers (both live in ProcessSchedules, so the CLI discriminates by queue binding). The curated output carries a canonical `Type` field with one of `Time`, `Queue`, or `Api` across `create`/`get`/`list` (use `--all-fields` for the raw entity, where api triggers report `Http`). `get` also returns `StartProcessCronSummary` (a human-readable cron, e.g. "At 12:00 PM").
+
+> **Enum flag values are case-insensitive.** `--method POST`, `--runtime-type SERVERLESS`, `--job-priority HIGH` all work and are normalized to canonical PascalCase before the API call. Same on `queue-items` (`--priority high` ≡ `High`) and `processes update` (`--retention-action delete`, `--robot-size standard`).
 
 ---
 
@@ -144,9 +146,9 @@ exclusive `--enabled` / `--disabled` flags. Same applies to all three
 trigger types (time, queue, api).
 
 ```bash
-uip resource triggers update <trigger-key> --type time --folder-path "Finance" --disabled --output json
-uip resource triggers update <trigger-key> --type time --folder-path "Finance" --enabled --output json
-uip resource triggers delete <trigger-key> --type time --folder-path "Finance" --output json
+uip or triggers update <trigger-key> --type time --folder-path "Finance" --disabled --output json
+uip or triggers update <trigger-key> --type time --folder-path "Finance" --enabled --output json
+uip or triggers delete <trigger-key> --type time --folder-path "Finance" --yes --output json
 ```
 
 ---
@@ -156,10 +158,10 @@ uip resource triggers delete <trigger-key> --type time --folder-path "Finance" -
 Shows every activation attempt and why it succeeded or failed. Check this before assuming broken config.
 
 ```bash
-uip resource triggers history <trigger-key> --folder-path "Finance" --output json
+uip or triggers history <trigger-key> --folder-path "Finance" --output json
 ```
 
-Entries include `logEventType` (Fired, Failed, Skipped) and `message` ("No machines available", "License limit reached", "Calendar exclusion").
+Entries are curated rows with `TimeStamp`, `EventType` (Fired, Failed, Skipped, DisabledDueToConsecutiveFailures, ...), `Level`, `Message` ("No machines available", "License limit reached", "Calendar exclusion") and `TriggerKey`. The response includes a `Pagination` block; pass `--all-fields` for the raw DTO.
 
 ---
 
@@ -170,10 +172,10 @@ Webhooks are **tenant-scoped** -- no `--folder-path` needed. They POST to your U
 ### Discover Event Types
 
 ```bash
-uip resource webhooks event-types --output json
+uip or webhooks event-types --output json
 ```
 
-Returns names like `job.completed`, `job.faulted`, `queueItem.failed`. Use these with `--events`.
+Returns names like `job.completed`, `job.faulted`, `queueItem.failed`. Use these with `--events`. The response carries the standard `Pagination` block (full enumeration in one call, `HasMore` always false).
 
 ### Create a Webhook
 
@@ -181,13 +183,13 @@ The webhook name is a **positional argument**, aligned with `calendars create <n
 
 ```bash
 # Subscribe to specific events
-uip resource webhooks create "JobFailureAlert" \
+uip or webhooks create "JobFailureAlert" \
   --url "https://hooks.example.com/uipath" \
   --events "job.faulted,job.stopped" \
   --secret "my-signing-secret" --output json
 
 # Subscribe to ALL events (omit --events)
-uip resource webhooks create "AuditHook" \
+uip or webhooks create "AuditHook" \
   --url "https://hooks.example.com/audit" --output json
 ```
 
@@ -199,21 +201,23 @@ Options:
 ### List, Get, Update, Test, Delete
 
 ```bash
-uip resource webhooks list --enabled --output json
-uip resource webhooks get <webhook-key> --output json
+uip or webhooks list --enabled --output json
+uip or webhooks get <webhook-key> --output json
 
-uip resource webhooks update <webhook-key> \
+uip or webhooks update <webhook-key> \
   --url "https://new.example.com/hook" \
   --events "job.faulted,queueItem.failed" --output json
 
 # Toggle without renaming or changing other fields:
-uip resource webhooks update <webhook-key> --disabled --output json
-uip resource webhooks update <webhook-key> --enabled --output json
+uip or webhooks update <webhook-key> --disabled --output json
+uip or webhooks update <webhook-key> --enabled --output json
 
-uip resource webhooks ping <webhook-key> --output json     # test connectivity
-uip resource webhooks delete <webhook-key> --output json
+uip or webhooks ping <webhook-key> --output json     # dispatch a test ping event
+uip or webhooks delete <webhook-key> --yes --output json
 ```
 
+> **`ping` reports dispatch, not delivery.** The ping event goes through the asynchronous event pipeline; Success means the ping was queued, not that the endpoint answered. The API exposes no delivery result, so confirm receipt on the receiving endpoint (or its logs).
+
 ---
 
 ## Complete Example
@@ -227,7 +231,7 @@ uip or processes list --folder-path "Finance" --output json
 
 # 2. Time trigger: weekdays at 9 AM, skip US holidays
 uip or calendars list --output json   # get calendar key
-uip resource triggers create --type time \
+uip or triggers create --type time \
   --name "WeekdayInvoiceRun" \
   --release-key "c3d4e5f6-..." \
   --cron "0 0 9 ? * MON-FRI" --time-zone "UTC" \
@@ -235,8 +239,8 @@ uip resource triggers create --type time \
   --runtime-type Unattended --job-priority Normal --output json
 
 # 3. Queue trigger: fire when 10+ items accumulate
-uip resource queues list --folder-path "Finance" --output json   # get queue key
-uip resource triggers create --type queue \
+uip or queues list --folder-path "Finance" --output json   # get queue key
+uip or triggers create --type queue \
   --name "InvoiceOverflowTrigger" \
   --release-key "c3d4e5f6-..." \
   --queue-key "d4e5f6a7-..." \
@@ -244,14 +248,14 @@ uip resource triggers create --type queue \
   --runtime-type Unattended --job-priority High --output json
 
 # 4. Webhook: notify on job failures
-uip resource webhooks create "InvoiceFailureAlert" \
+uip or webhooks create "InvoiceFailureAlert" \
   --url "https://hooks.slack.com/services/T00/B00/xxx" \
   --events "job.faulted,job.stopped" \
   --secret "webhook-signing-key" --output json
 
 # 5. Verify everything is active
-uip resource triggers list --type time --folder-path "Finance" --enabled --output json
-uip resource webhooks list --enabled --output json
+uip or triggers list --type time --folder-path "Finance" --enabled --output json
+uip or webhooks list --enabled --output json
 ```
 
 ---
@@ -271,7 +275,7 @@ uip resource webhooks list --enabled --output json
 
 ## Related
 
-- [resources.md](resources.md) — Resource tool overview and common flags
-- Get the release key for `--release-key` → [`uipath-orchestrator`](../orchestrator/run-jobs.md)
-- Calendar management + tenant settings affecting trigger behavior → [`uipath-orchestrator`](../orchestrator/tenant-admin.md)
+- [resources.md](resources.md) — Orchestrator resources overview and common flags
+- Get the release key for `--release-key` → [`uipath-orchestrator`](run-jobs.md)
+- Calendar management + tenant settings affecting trigger behavior → [`uipath-orchestrator`](tenant-admin.md)
 - [process-queues.md](process-queues.md) -- Queue setup required before creating queue triggers

package/skills/uipath-platform/references/{resources → orchestrator}/work-with-storage.md

@@ -2,7 +2,7 @@
 
 Create storage buckets, upload and download files, and generate presigned URLs for direct client access.
 
-> For full option details on any command, use `--help` (e.g., `uip resource buckets create --help`).
+> For full option details on any command, use `--help` (e.g., `uip or buckets create --help`).
 
 ## When to Use
 
@@ -11,7 +11,7 @@ Create storage buckets, upload and download files, and generate presigned URLs f
 
 ## Prerequisites
 
-- Authenticated (`uip login`)
+- Authenticated — verify with `uip login status`; if not logged in, ask the user to run `uip login` (it opens an interactive browser flow)
 - Target folder exists (`uip or folders list`)
 
 ## Flow
@@ -32,7 +32,7 @@ graph LR
 ### Create a Bucket
 
 ```bash
-uip resource buckets create "invoices" \
+uip or buckets create "invoices" \
   --folder-path "Finance" \
   --description "Invoice attachments and reports" \
   --output json
@@ -55,7 +55,7 @@ Key options:
 For external providers (Azure, Amazon):
 
 ```bash
-uip resource buckets create "cloud-reports" --folder-path "Finance" \
+uip or buckets create "cloud-reports" --folder-path "Finance" \
   --storage-provider Azure \
   --storage-parameters "DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=$Password" \
   --storage-container "reports-container" \
@@ -67,10 +67,10 @@ uip resource buckets create "cloud-reports" --folder-path "Finance" \
 
 ```bash
 # List buckets in a specific folder (folder required by default)
-uip resource buckets list --folder-path "Finance" --output json
+uip or buckets list --folder-path "Finance" --output json
 
 # List across every accessible folder (with optional name filter)
-uip resource buckets list --all-folders --name "invoice" --output json
+uip or buckets list --all-folders --name "invoice" --output json
 ```
 
 `buckets list` requires either `--folder-path` / `--folder-key` or `--all-folders`. Paginate with `--limit` / `--offset`. Sort with `--sort-by`. With `--all-folders`, use `--exclude-folder-path` / `--exclude-folder-key` to omit a folder.
@@ -78,23 +78,26 @@ uip resource buckets list --all-folders --name "invoice" --output json
 ### Get, Update, Delete
 
 ```bash
-uip resource buckets get <bucket-key> --folder-path "Finance" --output json
-uip resource buckets update <bucket-key> --folder-path "Finance" \
+uip or buckets get <bucket-key> --folder-path "Finance" --output json
+uip or buckets update <bucket-key> --folder-path "Finance" \
   --name "invoices-2026" --description "Updated invoice store" --output json
-uip resource buckets delete <bucket-key> --folder-path "Finance" --output json
+uip or buckets delete <bucket-key> --folder-path "Finance" --yes --output json
+# A bucket that still has files is refused; pass --force to delete it and
+# its files anyway.
+uip or buckets delete <bucket-key> --folder-path "Finance" --force --output json
 ```
 
 ### Share Buckets Across Folders
 
 ```bash
 # Share with another folder
-uip resource buckets share <bucket-key> --folder-path "Production" --output json
+uip or buckets share <bucket-key> --folder-path "Production" --output json
 
 # List folders that have access
-uip resource buckets list-folders <bucket-key> --folder-path "Finance" --output json
+uip or buckets list-folders <bucket-key> --folder-path "Finance" --output json
 
 # Remove from a folder
-uip resource buckets unshare <bucket-key> --folder-path "Production" --output json
+uip or buckets unshare <bucket-key> --folder-path "Production" --output json
 ```
 
 ---
@@ -104,11 +107,11 @@ uip resource buckets unshare <bucket-key> --folder-path "Production" --output js
 ### Upload a File
 
 ```bash
-uip resource bucket-files upload <bucket-key> "reports/summary.csv" \
+uip or bucket-files upload <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" --file ./summary.csv --output json
 
 # Specify content type explicitly
-uip resource bucket-files upload <bucket-key> "data/config.json" \
+uip or bucket-files upload <bucket-key> "data/config.json" \
   --folder-path "Finance" --file ./config.json \
   --content-type "application/json" --output json
 ```
@@ -119,10 +122,10 @@ uip resource bucket-files upload <bucket-key> "data/config.json" \
 
 ```bash
 # List all files in a bucket
-uip resource bucket-files list <bucket-key> --folder-path "Finance" --output json
+uip or bucket-files list <bucket-key> --folder-path "Finance" --output json
 
 # Filter by path prefix
-uip resource bucket-files list <bucket-key> --folder-path "Finance" \
+uip or bucket-files list <bucket-key> --folder-path "Finance" \
   --prefix "reports/" --output json
 ```
 
@@ -130,7 +133,7 @@ File listing uses **continuation-token pagination** (not offset/limit). Check th
 
 ```bash
 # Fetch next page
-uip resource bucket-files list <bucket-key> --folder-path "Finance" \
+uip or bucket-files list <bucket-key> --folder-path "Finance" \
   --continuation-token "<token-from-previous-response>" --output json
 ```
 
@@ -139,8 +142,8 @@ Additional options: `--take-hint <n>` (items per page, default 500, max 1000), `
 ### List Directories
 
 ```bash
-uip resource bucket-files list-dirs <bucket-key> --folder-path "Finance" --output json
-uip resource bucket-files list-dirs <bucket-key> --folder-path "Finance" \
+uip or bucket-files list-dirs <bucket-key> --folder-path "Finance" --output json
+uip or bucket-files list-dirs <bucket-key> --folder-path "Finance" \
   --directory "reports/" --file-name-glob "*.csv" --output json
 ```
 
@@ -150,19 +153,19 @@ Unlike `list`, `list-dirs` uses standard `--limit` / `--offset` pagination.
 
 ```bash
 # Get file metadata (no download)
-uip resource bucket-files get <bucket-key> "reports/summary.csv" \
+uip or bucket-files get <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" --output json
 
 # Download to a local file
-uip resource bucket-files download <bucket-key> "reports/summary.csv" \
+uip or bucket-files download <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" --destination ./summary.csv --output json
 
 # Write to stdout (pipe to another command)
-uip resource bucket-files download <bucket-key> "reports/summary.csv" \
+uip or bucket-files download <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" | jq .
 
 # Delete a file
-uip resource bucket-files delete <bucket-key> "reports/summary.csv" \
+uip or bucket-files delete <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" --output json
 ```
 
@@ -177,7 +180,7 @@ Presigned URLs allow external systems or users to upload/download files directly
 ### Get a Download URL
 
 ```bash
-uip resource bucket-files get-download-url <bucket-key> "reports/summary.csv" \
+uip or bucket-files get-download-url <bucket-key> "reports/summary.csv" \
   --folder-path "Finance" --expiry-in-minutes 15 --output json
 ```
 
@@ -186,7 +189,7 @@ Returns a presigned URL (GET verb). The URL expires after `--expiry-in-minutes`.
 ### Get an Upload URL
 
 ```bash
-uip resource bucket-files get-upload-url <bucket-key> "uploads/new-report.csv" \
+uip or bucket-files get-upload-url <bucket-key> "uploads/new-report.csv" \
   --folder-path "Finance" --expiry-in-minutes 30 \
   --content-type "text/csv" --output json
 ```
@@ -195,31 +198,49 @@ Returns a presigned URL (PUT verb) and any required headers (e.g., `x-ms-blob-ty
 
 Use cases: share temporary download links, allow external systems to upload directly, time-limited CI/CD access.
 
+### Upload via REST (when the CLI is not available)
+
+`bucket-files upload` already does presign + PUT in one step — prefer it. If a non-CLI system must upload, mirror the same two steps:
+
+```bash
+# 1. Get a presigned PUT URL (GetWriteUri). Single-URL-encode the path.
+curl -s -H "Authorization: Bearer $TOKEN" \
+  -H "X-UIPATH-OrganizationUnitId: $FOLDER_ID" \
+  "https://cloud.uipath.com/$ORG/$TENANT/orchestrator_/odata/Buckets($BUCKET_ID)/UiPath.Server.Configuration.OData.GetWriteUri?path=reports%2Fsummary.csv&contentType=text%2Fcsv"
+
+# 2. PUT the file to the returned Uri, including every header the response
+#    lists under RequiredHeaders (e.g. x-ms-blob-type: BlockBlob on Azure).
+curl -s -X PUT -H "x-ms-blob-type: BlockBlob" -H "Content-Type: text/csv" \
+  --data-binary @./summary.csv "$PRESIGNED_URI"
+```
+
+Caveats: the returned URI is short-lived (default 5–15 minutes); the `RequiredHeaders` differ per storage provider; and `GetWriteUri` corrupts paths containing `&`, `+`, `%`, or `?` (see Common Pitfalls below) — avoid those characters in file names.
+
 ---
 
 ## Complete Example
 
 ```bash
 # 1. Create the bucket
-uip resource buckets create "monthly-reports" \
+uip or buckets create "monthly-reports" \
   --folder-path "Finance" --description "Monthly financial reports" --output json
 
 # 2. Upload files
-uip resource bucket-files upload <bucket-key> "2026/04/revenue.csv" \
+uip or bucket-files upload <bucket-key> "2026/04/revenue.csv" \
   --folder-path "Finance" --file ./revenue.csv --output json
-uip resource bucket-files upload <bucket-key> "2026/04/expenses.pdf" \
+uip or bucket-files upload <bucket-key> "2026/04/expenses.pdf" \
   --folder-path "Finance" --file ./expenses.pdf --output json
 
 # 3. List files in the April directory
-uip resource bucket-files list <bucket-key> \
+uip or bucket-files list <bucket-key> \
   --folder-path "Finance" --prefix "2026/04/" --output json
 
 # 4. Download a file
-uip resource bucket-files download <bucket-key> "2026/04/revenue.csv" \
+uip or bucket-files download <bucket-key> "2026/04/revenue.csv" \
   --folder-path "Finance" --destination ./downloaded-revenue.csv --output json
 
 # 5. Generate a presigned download URL for sharing
-uip resource bucket-files get-download-url <bucket-key> "2026/04/expenses.pdf" \
+uip or bucket-files get-download-url <bucket-key> "2026/04/expenses.pdf" \
   --folder-path "Finance" --expiry-in-minutes 60 --output json
 ```
 
@@ -244,6 +265,7 @@ uip resource bucket-files get-download-url <bucket-key> "2026/04/expenses.pdf" \
 ### Common Pitfalls
 
 - **`buckets list` requires either `--folder-path`/`--folder-key` or `--all-folders`.** No-flag invocations error out — there is no implicit cross-folder default.
+- **File paths containing `&`, `+`, `%`, or `?` are rejected by the CLI.** The Orchestrator storage API builds presigned blob URIs without re-encoding URL-reserved characters, so such paths are silently corrupted server-side while the API reports success (`a&b.txt` is truncated to `a`; `+` and `%xx` decode to other characters; delete then operates on the corrupted name). The CLI refuses these paths up front on every path-taking command (`upload`, `download`, `delete`, `get`, `get-download-url`, `get-upload-url`). Rename files to avoid these characters. The same corruption applies when calling the REST API directly — the only REST workaround is double-URL-encoding the `path` parameter, which will break when the server-side fix lands; prefer renaming.
 - **`download` without `--destination`** writes to stdout. For binary files, always use `--destination`.
 - **External providers** (Azure, Amazon) require `--credential-store-key`. Use `uip or credential-stores list` to find keys.
 - **Bucket keys** are GUIDs (the `identifier` field from list/create output). Do not confuse with numeric `id`.
@@ -253,6 +275,6 @@ uip resource bucket-files get-download-url <bucket-key> "2026/04/expenses.pdf" \
 
 ## Related
 
-- [resources.md](resources.md) — Resource tool overview and libraries
-- Credential stores used by external storage providers → [`uipath-orchestrator`](../orchestrator/tenant-admin.md)
-- Folder setup → [`uipath-orchestrator`](../orchestrator/setup-environment.md)
+- [resources.md](resources.md) — Orchestrator resources overview and libraries
+- Credential stores used by external storage providers → [`uipath-orchestrator`](tenant-admin.md)
+- Folder setup → [`uipath-orchestrator`](setup-environment.md)

package/skills/uipath-platform/references/uip-commands.md

@@ -11,9 +11,10 @@
 **List command flags:**
 - `--limit <N>` / `--offset <N>` — pagination. Check `Pagination.HasMore` in output.
 - `--sort-by <field>` — sort results (e.g., `Name asc`, `Id desc`)
-- `--all-fields` — (Orchestrator tool only) return raw DTO instead of the
-  curated PascalCase projection. Resource tool returns full DTO by default
-  on every list/get and does not expose this flag.
+- `--all-fields` — return raw DTO instead of the curated PascalCase
+  projection. Native Orchestrator commands curate by default; the migrated
+  resource commands (assets, queues, buckets, etc.) return the full DTO by
+  default and do not expose this flag.
 
 ---
 
@@ -35,13 +36,13 @@ Manage folders, jobs, processes, machines, users, packages, and more. See [`uipa
 
 | Group | Key Commands | Workflow Guide |
 |---|---|---|
-| **Folders** | `list [--all]`, `get`, `create`, `edit`, `delete`, `move`, `runtimes` | [Setup Environment](orchestrator/setup-environment.md) |
+| **Folders** | `list [--all]`, `get`, `create`, `update`, `delete`, `move`, `runtimes` | [Setup Environment](orchestrator/setup-environment.md) |
 | **Jobs** | `list`, `get`, `start`, `stop`, `restart`, `resume`, `logs [--export]`, `traces`, `healing-data`, `history` | [Run Jobs](orchestrator/run-jobs.md) |
-| **Processes** | `list`, `get`, `resources`, `version-history`, `create`, `edit`, `update-version`, `rollback`, `delete` | [Run Jobs](orchestrator/run-jobs.md) |
+| **Processes** | `list`, `get`, `resources`, `version-history`, `create`, `update`, `update-version`, `rollback`, `delete` | [Run Jobs](orchestrator/run-jobs.md) |
 | **Packages** | `list`, `get`, `versions`, `entry-points`, `upload`, `download` | [Run Jobs](orchestrator/run-jobs.md) |
-| **Machines** | `list`, `get`, `create`, `edit`, `delete`, `assign`, `unassign` | [Setup Environment](orchestrator/setup-environment.md) |
-| **Users** | `list`, `list-in-folder`, `list-available`, `get`, `create`, `edit`, `delete`, `current`, `assign`, `unassign`, `assign-roles` | [Setup Environment](orchestrator/setup-environment.md) |
-| **Roles** | `list`, `permissions`, `get`, `create`, `edit`, `delete`, `users list`, `users set`, `user-roles list`, `user-permissions list`, `assign` | [Setup Environment](orchestrator/setup-environment.md) |
+| **Machines** | `list`, `get`, `create`, `update`, `delete`, `assign`, `unassign` | [Setup Environment](orchestrator/setup-environment.md) |
+| **Users** | `list`, `list-in-folder`, `list-available`, `get`, `create`, `update`, `delete`, `current`, `assign`, `unassign`, `assign-roles` | [Setup Environment](orchestrator/setup-environment.md) |
+| **Roles** | `list`, `permissions`, `get`, `create`, `update`, `delete`, `users list`, `users set`, `user-roles list`, `user-permissions list`, `assign` | [Setup Environment](orchestrator/setup-environment.md) |
 | **Sessions** | `attended list`, `unattended list`, `machines list <machine-key>`, `list-usernames`, `list-user-executors`, `toggle-debug-mode`, `delete-inactive`, `set-maintenance-mode` | [Manage Sessions](orchestrator/manage-sessions.md) |
 | **Settings** | `list`, `get`, `update`, `execution`, `timezones` | [Tenant Admin](orchestrator/tenant-admin.md) |
 | **Calendars** | `list`, `get`, `create`, `update`, `delete` | [Tenant Admin](orchestrator/tenant-admin.md) |
@@ -53,20 +54,20 @@ Manage folders, jobs, processes, machines, users, packages, and more. See [`uipa
 
 ---
 
-## Resource (`uip resource`)
+## Orchestrator resources (`uip or assets` / `queues` / `triggers` / …)
 
-Manage assets, queues, triggers, buckets, libraries, and webhooks. See [`uipath-resources`](resources/resources.md).
+Manage assets, queues, triggers, buckets, libraries, and webhooks — a subset of `uip or`. See [Orchestrator resources](orchestrator/resources.md).
 
 | Group | Key Commands | Workflow Guide |
 |---|---|---|
-| **Assets** | `list`, `get`, `create`, `update`, `delete`, `get-folders`, `share`, `unshare`, `get-asset-value` | [Manage Assets](resources/manage-assets.md) |
-| **Queues** | `list`, `get`, `create`, `update`, `delete`, `get-folders`, `get-stats`, `share`, `unshare` | [Process Queues](resources/process-queues.md) |
-| **Queue Items** | `list`, `get`, `add`, `bulk-add`, `update`, `set-progress`, `delete`, `delete-bulk`, `get-history`, `get-last-retry`, `has-video`, `set-review-status`, `set-reviewer`, `unset-reviewer`, `get-reviewers` | [Process Queues](resources/process-queues.md) |
-| **Buckets** | `list`, `get`, `create`, `update`, `delete`, `share`, `unshare`, `list-folders` | [Work with Storage](resources/work-with-storage.md) |
-| **Bucket Files** | `list`, `list-dirs`, `get`, `download`, `upload`, `delete`, `get-download-url`, `get-upload-url` | [Work with Storage](resources/work-with-storage.md) |
-| **Triggers** | `list`, `get`, `create`, `update [--enabled\|--disabled]`, `delete`, `history` | [Triggers & Webhooks](resources/triggers-and-webhooks.md) |
-| **Libraries** | `list`, `get`, `versions`, `upload`, `download`, `delete` | [Resources overview](resources/resources.md) |
-| **Webhooks** | `list`, `get`, `create`, `update`, `delete`, `ping`, `event-types` | [Triggers & Webhooks](resources/triggers-and-webhooks.md) |
+| **Assets** | `list`, `get`, `create`, `update`, `delete`, `get-folders`, `share`, `unshare`, `get-asset-value` | [Manage Assets](orchestrator/manage-assets.md) |
+| **Queues** | `list`, `get`, `create`, `update`, `delete`, `get-folders`, `get-stats`, `share`, `unshare` | [Process Queues](orchestrator/process-queues.md) |
+| **Queue Items** | `list`, `get`, `add`, `bulk-add`, `update`, `delete`, `delete-bulk`, `get-history`, `get-last-retry`, `has-video`, `set-review-status`, `set-reviewer`, `unset-reviewer`, `get-reviewers` | [Process Queues](orchestrator/process-queues.md) |
+| **Buckets** | `list`, `get`, `create`, `update`, `delete`, `share`, `unshare`, `list-folders` | [Work with Storage](orchestrator/work-with-storage.md) |
+| **Bucket Files** | `list`, `list-dirs`, `get`, `download`, `upload`, `delete`, `get-download-url`, `get-upload-url` | [Work with Storage](orchestrator/work-with-storage.md) |
+| **Triggers** | `list`, `get`, `create`, `update [--enabled\|--disabled]`, `delete`, `history` | [Triggers & Webhooks](orchestrator/triggers-and-webhooks.md) |
+| **Libraries** | `list`, `get`, `versions`, `upload`, `download`, `delete` | [Resources overview](orchestrator/resources.md) |
+| **Webhooks** | `list`, `get`, `create`, `update`, `delete`, `ping`, `event-types` | [Triggers & Webhooks](orchestrator/triggers-and-webhooks.md) |
 
 ---
 
@@ -124,4 +125,4 @@ LLM execution trace observability and feedback annotation. See [traces/traces.md
 ## Naming gotchas
 
 - Resource sub-nouns are **plural and hyphenated where shown**: `buckets`, `queues`, `assets`, `libraries`, `queue-items`, `bucket-files`. Never singular, never `queueitems`/`bucketfiles`.
-- The Orchestrator group prefix is `or`, not `orchestrator` (`uip orchestrator` does not exist). <!-- uip-check-skip -->
+- The canonical Orchestrator group prefix is `or`; `uip orchestrator` also works as a long-form alias, but these docs use `or`. <!-- uip-check-skip -->