# uip insights filter-queues

> Syntax and options for `uip insights filter-queues`, which discovers queues with recent Insights activity.

`uip insights filter-queues` discovers queues that have had Insights activity recently, restricted to folders the current caller can access.

:::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-queues 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-queues list

List queues with Insights activity in the backend's fixed 30-day window.

### 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-queues list
```

### Data shape

```json
{
  "Code": "InsightsFilterQueuesList",
  "Data": [
    {
      "queueName": "InvoiceProcessing",
      "folderKey": "f0f0f0f0-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 queue doesn't exist. `jobs` does not currently accept a queue-name filter; this command is a standalone discovery surface.

## Related

- [filter-folders](./uip-insights-filter-folders.md), [filter-processes](./uip-insights-filter-processes.md), [filter-machines](./uip-insights-filter-machines.md) — sibling discovery commands.

## See also

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