- Overview
- Get started
- Concepts
- Using UiPath CLI
- How-to guides
- CI/CD recipes
- Command reference
- Overview
- Exit codes
- Global options
- uip codedagent
- uip coder
- uip context-grounding
- uip docsai
- uip function
- uip guardrails
- uip llm-configuration
- uip llm-gateway
- uip maestro authoring
- uip maestro registry
- uip model-hub
- activities find
- activities get-default-xaml
- analyze
- analyzer-rules list
- build
- cleanup
- data-fabric-entities install
- data-fabric-entities list
- files diff
- get-library-object-repository
- get-object-repository
- init
- instances list
- pack
- packages inspect
- packages install
- packages versions
- publish
- remote
- restore
- run, debug & execution
- settings
- studio start
- templates search
- test-data add-entity
- test-data add-queue
- test-data add-variation
- tm
- uia
- validate
- workflow-examples get
- workflow-examples list
- uip tasks
- uip traces
- uip traces feedback
- Migration
- Reference & support
uip insights filter-machines
Syntax and options for `uip insights filter-machines`, which discovers machines with recent Insights activity for use with --machine-name filters.
uip insights filter-machines discovers machines that have had Insights activity recently, across the current tenant. Use it to find the --machine-name values that jobs accepts.
"Recent" is a fixed 30-day window set by the backend — it cannot be changed with a flag. This route is also feature-gated to Cloud and Dedicated SaaS deployments; on other deployment types the command fails with a ConfigError rather than an empty result.
Synopsis
uip insights filter-machines list [-l <n>] [-o <n>]
uip insights filter-machines list [-l <n>] [-o <n>]
This verb honors the global options and the standard exit codes. It does not accept -t, --tenant — it uses the tenant selected during uip login.
uip insights filter-machines list
List machines with Insights activity in the backend's fixed 30-day window, across the current tenant (unlike filter-folders and filter-processes, this isn't restricted to folders the caller can access).
Options
| Flag | Description |
|---|---|
-l, --limit <number> | Maximum rows to return. Defaults to 50. |
-o, --offset <number> | Rows to skip before returning results. |
Rows are deduplicated and sorted after fetching. Pagination is client-side, over the full unpaginated backend response.
Example
uip insights filter-machines list
uip insights filter-machines list
Data shape
{
"Code": "InsightsFilterMachinesList",
"Data": [
{
"machineName": "prod-worker-01",
"machineKey": "m0m0m0m0-0000-0000-0000-000000000001"
}
],
"Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}
{
"Code": "InsightsFilterMachinesList",
"Data": [
{
"machineName": "prod-worker-01",
"machineKey": "m0m0m0m0-0000-0000-0000-000000000001"
}
],
"Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}
An empty Data array means no matching activity in the 30-day window — it is not proof the machine doesn't exist.
Related
- jobs — accepts
--machine-namevalues discovered here. - filter-folders, filter-processes, filter-queues — sibling discovery commands.