Channels

Channels are Copera's workspace conversations. The Channels API lets integrations list channels and send messages — both to a channel and directly to a member — which makes it ideal for notifications, bot replies, workflow updates, and alerts.

Quick Start

REST API

# List channels
curl -X GET "https://api.copera.ai/public/v1/chat/channel/list?q=deploy" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Send a message to a channel
curl -X POST https://api.copera.ai/public/v1/chat/channel/CHANNEL_ID/send-message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Deploy to production finished ✅" }'

# Send a direct message to a member
curl -X POST https://api.copera.ai/public/v1/chat/direct-message/send-message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "USER_ID", "message": "Your report is ready." }'

Node.js SDK

npm install @copera.ai/sdk

import { CoperaAI } from '@copera.ai/sdk';

const copera = CoperaAI({ apiKey: 'YOUR_API_KEY' });

// Send a message to a channel
await copera.channel.sendMessage({
  channelId: 'CHANNEL_ID',
  message: 'Task completed successfully!',
  name: 'Automation Bot', // optional sender display name
});

@copera.ai/sdk

Full SDK documentation and source code

CLI

curl -fsSL https://cli.copera.ai/install.sh | bash

# List channels
copera channels list
copera channels list --query "deploy"

# Send to a channel
copera channels message send "Hello from the CLI!" --channel <channel-id>

# Send a direct message to a member
copera channels message send "Your report is ready." --user <user-id>

copera-cli

CLI configuration and full command reference

GitHub Action

Send Copera notifications directly from your CI/CD pipelines:

name: Deploy Notification

on:
  push:
    branches: [main]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - name: Send Copera Notification
        uses: copera-ai/copera-action@v3
        with:
          api_token: ${{ secrets.COPERA_GITHUB }}
          channel_id: ${{ vars.COPERA_GITHUB_CHANNEL }}
          message: "New deployment to production!"
          sender_name: "GitHub Actions"

Input	Required	Description
api_token	Yes	Your Copera API token (store it in GitHub Secrets)
channel_id	Yes	Target channel ID
message	Yes	Message content (1–10,000 characters)
sender_name	No	Custom sender display name
debug	No	Enable detailed logging (true / false)

Copera Action

GitHub Marketplace listing and full documentation

Available in

Public API	CLI	MCP	Copera AI
✅ Full	✅ Full	✅ Full	—

The CLI and the hosted MCP server cover listing channels and sending channel and direct messages. Channels are not exposed to the in-app Copera AI assistant.

Next

• Text Channel Messaging — listing channels and filters, posting to a channel vs sending a direct message, the supported markdown format, participant permissions, and response semantics.
• Channels in the API Reference — list channels, send channel message, and send direct message with full schemas.