# Overview

What connected channels are and how to discover them.



A **connected channel** is a Slack or Discord channel that your organization has linked to Nairi. Once a channel is connected, agents can post to it, receive prompts from it, and serve as the channel's default responder. The channels API is read-only — you discover existing channels here; you connect new ones from the [Nairi dashboard](https://app.nairi.ai).

## How it works [#how-it-works]

Each connected channel has two important identifiers:

* **`id`** — the internal Nairi record ID (`cc_…`). Used inside the platform; **don't pass this to other endpoints**.
* **`channel_id`** — the platform-native ID (Slack's `Cxxx…`, Discord's numeric snowflake). This is what every other API endpoint expects.

The most common reason to call this API is to look up a channel's platform `channel_id` so you can pass it as `connected_channel_id` when [creating a scheduled job](/api/scheduled-jobs/create).

## When to use it [#when-to-use-it]

* **Wire up a recurring digest into your team's Slack or Discord.** Look up the target channel here, then drop the `channel_id` into [Scheduled jobs](/api/scheduled-jobs/overview).
* **Check how and where your agents are connected.** List channels to see which has a `default_agent_id` set and what `mode` (`ask` or `execute`) it defaults to.

To connect a new Slack workspace or Discord server, install the Nairi app in the destination platform from the dashboard — this API does not expose connect/disconnect operations.