Add OpenAPI docs for Sourcebot public API (#996)

* Add OpenAPI docs for Sourcebot public API

Generate and publish OpenAPI docs for the public search, repo, and file-browsing endpoints, add Mintlify integration, and serve the generated spec at /api/openapi.json.

Note: /api/stream_search remains modeled as text/event-stream in OpenAPI. OpenAPI 3.0 does not provide a first-class way to describe SSE frames as a typed stream of JSON events.

* Address OpenAPI PR review feedback

Remove the localhost servers entry, clarify the SSE stream description, point docs readers at /api/openapi.json, add the changelog entry, and update the lockfile metadata.

* update release flow to commit docs changes on version change

* feedback

* feedback

---------

Co-authored-by: Brendan Kellam <brendan@sourcebot.dev>

Author: KonradStanski

.github/workflows/release-prod.yml

@@ -126,14 +126,25 @@ jobs:
           echo "Updated version.ts with version v$VERSION"
           cat packages/shared/src/version.ts
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Generate OpenAPI docs
+        run: yarn openapi:generate
+
       - name: Configure git
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
       - name: Commit changes
         run: |
-          git add CHANGELOG.md packages/shared/src/version.ts
+          git add CHANGELOG.md packages/shared/src/version.ts docs/api-reference/sourcebot-public.openapi.json
           git commit -m "[skip ci] Release v$VERSION"
 
       - name: Push to temporary branch

CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - Require explicit invocation of ask_codebase tool in MCP [#995](https://github.com/sourcebot-dev/sourcebot/pull/995)
 - Gate MCP API behind authentication when Ask GitHub is enabled. [#994](https://github.com/sourcebot-dev/sourcebot/pull/994)
+- Added generated OpenAPI documentation for the public search, repo, and file browsing API surface. [#101](https://github.com/sourcebot-dev/sourcebot/issues/101)
 
 ## [4.15.4] - 2026-03-11
 

Dockerfile

@@ -220,6 +220,9 @@ RUN chown -R sourcebot:sourcebot /app
 # Copy zoekt proto files (needed for gRPC client at runtime)
 COPY --chown=sourcebot:sourcebot vendor/zoekt/grpc/protos /app/vendor/zoekt/grpc/protos
 
+# Copy OpenAPI docs
+COPY --chown=sourcebot:sourcebot docs/api-reference/sourcebot-public.openapi.json /app/docs/api-reference/sourcebot-public.openapi.json
+
 # Copy all of the things
 COPY --chown=sourcebot:sourcebot --from=web-builder /app/packages/web/public ./packages/web/public
 COPY --chown=sourcebot:sourcebot --from=web-builder /app/packages/web/.next/standalone ./