Beever Atlas v0.1 has launched! Star us on GitHub
Beever AtlasBeever Atlas

Channels API

Overview

Manage and monitor connected communication channels (Slack, Discord, etc.).

GET /api/channels

List all channels across all connected platforms.

Response

[
  {
    "id": "C12345",
    "name": "#engineering",
    "platform": "slack",
    "connected": true,
    "last_sync": "2026-04-13T10:30:00Z",
    "message_count": 15234,
    "fact_count": 856
  }
]

Fields

Prop

Type

GET /api/channels/{channel_id}

Get detailed information about a specific channel.

Parameters

Prop

Type

Response

{
  "id": "C12345",
  "name": "#engineering",
  "platform": "slack",
  "connected": true,
  "last_sync": "2026-04-13T10:30:00Z",
  "created_at": "2026-01-01T00:00:00Z",
  "message_count": 15234,
  "fact_count": 856,
  "entity_count": 45,
  "topic_count": 23,
  "wiki_page_count": 12,
  "settings": {
    "sync_enabled": true,
    "wiki_enabled": true,
    "graph_enabled": true
  }
}

GET /api/channels/{channel_id}/messages

List messages from a channel with pagination.

Parameters

Prop

Type

Response

{
  "messages": [
    {
      "id": "1234567890.123456",
      "text": "Message content...",
      "author": {
        "id": "U12345",
        "name": "Jane Smith"
      },
      "timestamp": "2026-04-13T10:30:00Z",
      "thread_ts": null,
      "reactions": [
        {"emoji": "thumbsup", "count": 3, "users": ["U123", "U456"]}
      ],
      "attachments": [],
      "has_media": false
    }
  ],
  "has_more": true,
  "next_cursor": "2026-04-13T10:25:00Z"
}

DELETE /api/channels/{channel_id}/data

Delete all data for a channel (messages, facts, wiki). Use with caution.

Response

{
  "deleted_facts": 856,
  "deleted_entities": 45,
  "deleted_wiki_pages": 12
}

Channel Statistics

GET /api/channels/{channel_id}/stats

Get statistics for a specific channel.

{
  "message_count": 15234,
  "fact_count": 856,
  "entity_count": 45,
  "decision_count": 23,
  "author_count": 15,
  "date_range": {
    "earliest": "2026-01-01T00:00:00Z",
    "latest": "2026-04-13T10:30:00Z"
  },
  "top_authors": [
    {"name": "Alice Johnson", "message_count": 2341},
    {"name": "Bob Smith", "message_count": 1876}
  ]
}

Channel Settings

GET /api/channels/{channel_id}/settings

Get channel-specific settings.

PUT /api/channels/{channel_id}/settings

Update channel settings.

{
  "sync_enabled": true,
  "wiki_enabled": true,
  "graph_enabled": true,
  "fact_extraction_enabled": true,
  "retention_days": 365
}
How is this guide?

On this page

Ready for production?

Ship to production with SSO, audit logs, spend controls, and guardrails your security team will approve.

Talk to the team

or email hello@beever.ai