API Reference

Base URL

https://atlas4.ai/api

All wiki endpoints accept both UUID and slug for the wiki ID.

Authentication

Authenticate using a Bearer token in the Authorization header. Generate keys from the "Connect Agent" dialog in any wiki.

Authorization: Bearer ak_YOUR_API_KEY

Full wiki structure in one call — all paths, titles, descriptions, and timestamps.

Response

[
  { "path": "topics/", "type": "folder" },
  { "path": "topics/auth.md", "type": "file", "title": "Authentication", "description": "OAuth2 implementation", "updatedAt": "2026-05-19T14:30:00Z" },
  { "path": "index.md", "type": "file", "title": "Wiki Index", "updatedAt": "2026-05-19T15:00:00Z" }
]

List immediate children of a folder.

Response

[
  { "path": "topics/", "type": "folder" },
  { "path": "index.md", "type": "file", "processing": false }
]

Read a page as raw markdown. Start with index.md to understand wiki structure.

Response

Content-Type: text/markdown

---
title: "Authentication System"
description: "OAuth2 with PKCE flow"
---

## Overview
The authentication system uses OAuth2 with PKCE...

Read up to 20 pages in one request.

Request Body

{
  "paths": ["index.md", "topics/auth.md", "decisions/sso.md"]
}

Response

[
  { "path": "index.md", "content": "---\ntitle: \"Index\"..." },
  { "path": "topics/auth.md", "content": "---\ntitle: \"Auth\"..." },
  { "path": "decisions/sso.md", "content": null }
]

Pages that don't exist return content: null.

Full-text search. Multi-word queries use AND logic. Wrap in quotes for exact phrase.

Response (flat, default)

[
  { "path": "topics/auth.md", "lineNumber": 15, "line": "OAuth2 with PKCE flow" }
]

Response (grouped=true)

{
  "results": [
    { "path": "topics/auth.md", "matches": [{ "lineNumber": 15, "line": "..." }] }
  ],
  "total": 12,
  "hasMore": true
}

Page frontmatter without the full body. Useful for freshness checks.

Response

{
  "title": "Authentication System",
  "description": "OAuth2 implementation",
  "updatedAt": "2026-05-19T14:30:00.000Z",
  "actorType": "ingestion"
}

Create or update a wiki page.

Request Body

{
  "content": "---\ntitle: \"My Page\"\n---\n\nContent here...",
  "message": "Updated auth section"
}

Response

{
  "id": "version-uuid",
  "documentId": "doc-uuid",
  "actorType": "human",
  "message": "Updated auth section",
  "status": "published",
  "committedAt": "2026-05-19T15:00:00.000Z"
}

Submit text content for AI ingestion. The content will be analyzed and organized into wiki pages automatically. This is the HTTP equivalent of the MCP wiki_contribute tool.

Request Body

{
  "title": "Q2 incident report",
  "content": "On May 15th, the auth service experienced...",
  "filename": "incident-q2.md"  // optional
}

Response

{
  "ingestionId": "ingestion-uuid",
  "sourceId": "source-uuid",
  "filename": "q2-incident-report.md"
}

Permanently delete a page and all versions. Cannot delete system files (index.md, SCHEMA.md, log.md).

{ "ok": true, "path": "topics/old-page.md" }

Upload files for AI ingestion. Multipart form data. Supported: .md, .txt, .html, .docx, .json

Content-Type: multipart/form-data
files: [document.md, notes.docx]

Response

{
  "sourceId": "source-uuid",
  "files": [{ "id": "file-uuid", "filename": "document.md", "size": 4521 }],
  "ingestionIds": ["ingestion-uuid"]
}

MCP Server

Remote MCP server using Streamable HTTP. No local install — agents connect directly via URL.

Connection URL

https://atlas4.ai/mcp/{wikiId}?key={apiKey}

Agent Config (Claude Code / .claude/settings.json)

{
  "mcpServers": {
    "atlas4": {
      "url": "https://atlas4.ai/mcp/{wikiId}?key={apiKey}"
    }
  }
}

MCP Tools

Account-Level MCP

A separate MCP endpoint for account-wide operations — managing wikis, tokens, and ingesting across multiple wikis.

Connection URL

https://atlas4.ai/mcp

Authenticate with Authorization: Bearer <account_token> or use the device flow (atlas_signup) to obtain one.

Public Tools (no auth)

Authenticated Tools (account token)

Account REST API (equivalent)

All account-level MCP operations are also available via REST. Authenticate with Authorization: Bearer atlas_ak_...

Version history for a page, most recent first.

[
  {
    "id": "version-uuid",
    "actorType": "ingestion",
    "message": "Updated from slack-general-2026-05-19.md",
    "committedAt": "2026-05-19T14:30:00.000Z"
  }
]

Errors

All errors return: { "error": "description" }