Getting started

Introduction

ScopeDocs is an AI knowledge base for engineering documentation. This guide covers the public API for accessing source-linked docs, knowledge graphs, pull request insights, and grounded chat from your own tools and agents.

What is ScopeDocs?

ScopeDocs unifies GitHub, Slack, Linear, and Supabase into one AI knowledge base for engineering documentation. It builds source-linked docs and answers grounded in your live codebase and workflow, so your documentation stays current as you ship.

Instead of scattered PRs, tickets, chat threads, and schema changes, ScopeDocs gives your team a single source of truth that evolves as you build. Every answer can be traced back to the underlying source material.

The Public API

The ScopeDocs Public API (/api/v1) gives you programmatic access to the verified context ScopeDocs has indexed across your workspace:

  • Source-linked documentation — list, search, and retrieve generated docs
  • Knowledge graphs — nodes, relationships, and full graph data per repo
  • Pull request context — synced from GitHub with AI explanations
  • Grounded chat — ask questions about your codebase in natural language
Note:

The public API is designed for agents, CI pipelines, and internal tooling. Authentication uses API keys — not user sessions. Learn how to create an API key →

Available Endpoints

EndpointScopeDescription
GET /api/v1/docsdocs:readList generated docs
GET /api/v1/docs/searchdocs:readVector search over docs
GET /api/v1/docs/{id}docs:readGet full doc content
GET /api/v1/graph/reposgraph:readList indexed repos
GET /api/v1/graph/node/{id}graph:readGet a graph node
GET /api/v1/graph/{repo}graph:readFull knowledge graph
GET /api/v1/prs/{repo}/{n}prs:readGet PR + AI explanation
POST /api/v1/chatchatRAG chat over your codebase

Base URL

All API requests are made to:

https://scopedocs-ai-production.up.railway.app