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

Wiki API

Overview

Access and manage auto-generated wiki pages from team knowledge.

GET /api/wiki/structure

Get the wiki navigation structure for a channel.

Query Parameters

Prop

Type

Response

{
  "channel_id": "C12345",
  "channel_name": "#engineering",
  "platform": "slack",
  "generated_at": "2026-04-13T10:30:00Z",
  "is_stale": false,
  "pages": [
    {
      "id": "overview",
      "title": "Overview",
      "slug": "overview",
      "section_number": "1",
      "page_type": "fixed",
      "memory_count": 0,
      "children": []
    },
    {
      "id": "people",
      "title": "People",
      "slug": "people",
      "section_number": "2",
      "page_type": "fixed",
      "memory_count": 0,
      "children": []
    },
    {
      "id": "topic-authentication",
      "title": "Authentication System",
      "slug": "topic/authentication",
      "section_number": "3",
      "page_type": "topic",
      "memory_count": 15,
      "children": [
        {
          "id": "topic-auth--jwt-migration",
          "title": "JWT Migration",
          "slug": "topic/authentication/jwt-migration",
          "section_number": "3.1",
          "page_type": "sub-topic",
          "memory_count": 8
        }
      ]
    }
  ]
}

GET /api/wiki/pages/{page_id}

Get a specific wiki page content.

Parameters

Prop

Type

Response

{
  "id": "overview",
  "slug": "overview",
  "title": "Overview",
  "page_type": "fixed",
  "parent_id": null,
  "section_number": "1",
  "content": "# Engineering Channel\n\n## Purpose\n\nThis channel...",
  "summary": "Overview of the Engineering team's activities and focus areas.",
  "memory_count": 0,
  "last_updated": "2026-04-13T10:30:00Z",
  "citations": [
    {
      "id": "[1]",
      "author": "Jane Smith",
      "channel": "#engineering",
      "timestamp": "2026-04-13T10:30:00Z",
      "text_excerpt": "Our team focuses on backend API development...",
      "permalink": "https://slack.com/archives/C12345/p1234567890",
      "media_type": null,
      "media_name": null
    }
  ],
  "children": []
}

POST /api/wiki/refresh

Trigger wiki regeneration for a channel.

Request Body

{
  "channel_id": "C12345",
  "force": false
}

Response

{
  "status": "started",
  "job_id": "wiki_job_123",
  "estimated_duration_seconds": 120
}

GET /api/wiki/versions

List all wiki versions for a channel.

Parameters

Prop

Type

Response

{
  "versions": [
    {
      "version_number": 3,
      "channel_id": "C12345",
      "generated_at": "2026-04-13T10:30:00Z",
      "archived_at": "2026-04-13T09:00:00Z",
      "page_count": 12,
      "model": "claude-3-5-sonnet-20241022"
    }
  ]
}

GET /api/wiki/versions/{version_number}

Get a specific wiki version snapshot.

Parameters

Prop

Type

Response

{
  "version_number": 2,
  "channel_id": "C12345",
  "channel_name": "#engineering",
  "platform": "slack",
  "generated_at": "2026-04-12T10:30:00Z",
  "archived_at": "2026-04-13T09:00:00Z",
  "page_count": 10,
  "model": "claude-3-5-sonnet-20241022",
  "structure": {...},
  "overview": {...},
  "pages": {...},
  "metadata": {...}
}

GET /api/wiki/activity

Get recent wiki generation activity.

Parameters

Prop

Type

Response

{
  "activities": [
    {
      "channel_id": "C12345",
      "action": "generated",
      "version_number": 3,
      "page_count": 12,
      "duration_ms": 85000,
      "timestamp": "2026-04-13T10:30:00Z"
    }
  ]
}

GET /api/wiki/sync-history

Get wiki generation sync history.

Parameters

Prop

Type

Response

{
  "history": [
    {
      "sync_id": "sync_123",
      "started_at": "2026-04-13T10:28:00Z",
      "completed_at": "2026-04-13T10:30:00Z",
      "status": "completed",
      "pages_generated": 12,
      "facts_processed": 856,
      "error": null
    }
  ]
}

GET /api/wiki/status

Get wiki generation status for a channel.

Parameters

Prop

Type

Response

{
  "channel_id": "C12345",
  "is_generating": false,
  "is_stale": false,
  "last_generated_at": "2026-04-13T10:30:00Z",
  "current_version": 3,
  "page_count": 12,
  "next_generation_scheduled": null
}

Wiki Page Types

Fixed Pages

Always available for every channel:

  • overview (1) - Channel overview and purpose
  • people (2) - Team members and roles
  • decisions (3) - Key decisions and outcomes
  • faq (4) - Frequently asked questions
  • glossary (5) - Domain terminology
  • activity (6) - Recent activity timeline
  • topics (7) - All topic clusters

Topic Pages

Auto-generated from topic clusters:

  • topic-{slug} - Main topic page
  • topic-{slug}--{sub-slug} - Sub-topic pages

Example Page IDs

overview
people
decisions
topic-authentication
topic-authentication--jwt-migration
topic-api-design
topic-api-design--rest-vs-graphql

Wiki Metadata

GET /api/wiki/metadata

Get generation metadata for a channel's wiki.

{
  "member_count": 15,
  "message_count": 15234,
  "memory_count": 856,
  "entity_count": 45,
  "media_count": 23,
  "page_count": 12,
  "generation_cost_usd": 0.85,
  "generation_duration_ms": 85000
}
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