Overview

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.

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.

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.
• 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.