Overview
What connected channels are, how to discover the Slack and Discord channels your Nairi organization has connected, and what you can change on them via the REST API.
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. You discover channels here and, for Slack channels, change the agent, the mode and auto-reply with Update. Connecting a new channel is done 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'sCxxx…, 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_idinto Scheduled jobs. - Check how and where your agents are connected. List channels to see which has a
default_agent_idset and whatmode(askorexecute) it defaults to. - Wire an alert channel to an agent from a provisioning script. Create and deploy the agent, then update the channel with
default_agent_id,default_modeandauto_reply: true, so Nairi acts on every new post there without being tagged.
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, and Discord channels cannot be changed through it yet.