# 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](./uip-insights-jobs.md) accepts.

:::note
"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

```text
uip insights filter-machines list [-l <n>] [-o <n>]
```

This verb honors the [global options](./global-options.md) and the standard [exit codes](./exit-codes.md). 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](./uip-insights-filter-folders.md) and [filter-processes](./uip-insights-filter-processes.md), 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

```bash
uip insights filter-machines list
```

### Data shape

```json
{
  "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](./uip-insights-jobs.md) — accepts `--machine-name` values discovered here.
- [filter-folders](./uip-insights-filter-folders.md), [filter-processes](./uip-insights-filter-processes.md), [filter-queues](./uip-insights-filter-queues.md) — sibling discovery commands.

## See also

- [Insights overview](./uip-insights.md)