# pipeline::list

Shows managed pipelines.

```tql
pipeline::list
```

## Description

The `pipeline::list` operator returns the list of all managed pipelines. Managed pipelines are pipelines created through the [`/pipeline` API](https://preview.docs.tenzir.com/375/375/reference/node/api.md), which includes all pipelines run through the Tenzir Platform.

## Examples

### Count pipelines per state

```tql
pipeline::list
top state
```

```tql
{
  "state": "running",
  "count": 31
}
{
  "state": "failed",
  "count": 4
}
{
  "state": "stopped",
  "count": 2
}
```

### Show pipelines per package

```tql
pipeline::list
summarize package, names=collect(name)
```

```tql
{
  "package": "suricata-ocsf",
  "names": [
    "Suricata Flow to OCSF Network Activity",
    "Suricata DNS to OCSF DNS Activity",
    "Suricata SMB to OCSF SMB Activity",
    // …
  ]
}
```

## See Also

* [`package::list`](https://preview.docs.tenzir.com/375/375/reference/operators/package/list.md)
* [`pipeline::detach`](https://preview.docs.tenzir.com/375/375/reference/operators/pipeline/detach.md)
* [`pipeline::run`](https://preview.docs.tenzir.com/375/375/reference/operators/pipeline/run.md)