> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/the-workspace/pipelines/listeners.md).

# Listeners

The default tab that opens when in the Pipeline area is the Listeners tab, which shows all Listeners in your Tenant, as well as their labels.

<div data-full-width="false"><figure><picture><source srcset="/files/iSL2xZsmAbwY3UgBzGqw" media="(prefers-color-scheme: dark)"><img src="/files/8q2yLRXiIMURkBYvffQA" alt=""></picture><figcaption></figcaption></figure></div>

Use the search bar to find a specific Listener or Label.

## Edit a Listener

You can edit a label from the list by clicking the ellipses next to its name and selecting **Edit**.

<figure><picture><source srcset="/files/Mnki72UNKSz0N16GJtJd" media="(prefers-color-scheme: dark)"><img src="/files/bCkHrK31BpaNnwcLDfRB" alt=""></picture><figcaption></figcaption></figure>

This will open the Listener [Configuration](/the-workspace/listeners.md) and [Labels](/the-workspace/listeners/labels.md) for you to modify.

## Create Listener

If the Listener you wish to use in the Pipeline does not already exist, you can create it directly from this view using the **Create Listener** button in the bottom right of the tab. This will open the **Listener Configuration** window.

## Add a Listener to your Pipeline

Go to [Building a Pipeline](/the-workspace/pipelines/building-a-pipeline.md) to learn step by step.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.onum.com/the-workspace/pipelines/listeners.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
