Agent Channels

Channel endpoints let you manage external integrations like Discord, Slack, and Telegram for your agents. The API channel is always available by default.

Endpoints

Method	Endpoint	Description
`GET`	`/v1/agent/{id}/channels`	List all channel bindings
`POST`	`/v1/agent/{id}/discord/link`	Generate a Discord link code
`GET`	`/v1/agent/{id}/discord/status`	Check Discord link status
`DELETE`	`/v1/agent/{id}/discord/unlink`	Unlink Discord account
`POST`	`/v1/agent/{id}/slack/link`	Generate a Slack link code
`GET`	`/v1/agent/{id}/slack/status`	Check Slack link status
`DELETE`	`/v1/agent/{id}/slack/unlink`	Unlink Slack account
`POST`	`/v1/agent/{id}/telegram/link`	Generate a Telegram link code
`GET`	`/v1/agent/{id}/telegram/status`	Check Telegram link status
`DELETE`	`/v1/agent/{id}/telegram/unlink`	Unlink Telegram account

Linking Workflow

All channel integrations follow a similar workflow:

Generate a link code via POST /v1/agent/{id}/{channel}/link (expires in 10 minutes)
Send /link CODE to the appropriate bot:
- Discord: Send as DM to the Shinzo bot
- Slack: Send as DM to your agent’s Slack bot
- Telegram: Send as message to your agent’s Telegram bot
Start chatting — messages are routed to your agent automatically

Supported channels: Discord, Slack, and Telegram. WhatsApp support is coming soon.

For a full guide on channel integrations, see Agent Messaging & Channels.