From df100082e6336b26f5d0ac943ae9673c5aa0e06b Mon Sep 17 00:00:00 2001
From: Dotta <bippadotta@protonmail.com>
Date: Fri, 5 Jun 2026 03:29:45 +0000
Subject: [PATCH] PAP-10287 document teams catalog routes

Co-Authored-By: Paperclip <noreply@paperclip.ing>
---
 server/src/__tests__/openapi-routes.test.ts |  1 +
 server/src/routes/openapi.ts                | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/server/src/__tests__/openapi-routes.test.ts b/server/src/__tests__/openapi-routes.test.ts
index 4c4e8efb023..36d0bafbb3d 100644
--- a/server/src/__tests__/openapi-routes.test.ts
+++ b/server/src/__tests__/openapi-routes.test.ts
@@ -42,6 +42,7 @@ const apiPrefixes: Record<string, string> = {
   "secrets.ts": "/api",
   "sidebar-badges.ts": "/api",
   "sidebar-preferences.ts": "/api",
+  "teams-catalog.ts": "/api",
   "user-profiles.ts": "/api",
 };
 
diff --git a/server/src/routes/openapi.ts b/server/src/routes/openapi.ts
index e0aab890c3b..db4ff1ab4ce 100644
--- a/server/src/routes/openapi.ts
+++ b/server/src/routes/openapi.ts
@@ -871,6 +871,24 @@ registry.registerPath({
   responses: { 200: r.ok(), 400: r.badRequest, 401: r.unauthorized },
 });
 
+// ─── Teams Catalog ──────────────────────────────────────────────────────────
+
+for (const route of [
+  ["get", "/api/teams/catalog", "List catalog teams"],
+  ["get", "/api/teams/catalog/{catalogId}/files", "Get catalog team file"],
+  ["get", "/api/teams/catalog/{catalogId}", "Get catalog team"],
+  ["get", "/api/companies/{companyId}/teams/catalog/installed", "List installed catalog teams"],
+  ["post", "/api/companies/{companyId}/teams/catalog/{catalogId}/preview", "Preview catalog team install"],
+  ["post", "/api/companies/{companyId}/teams/catalog/{catalogId}/install", "Install catalog team"],
+] as const) {
+  registerCurrentRoute({
+    method: route[0],
+    path: route[1],
+    tags: ["teams"],
+    summary: route[2],
+  });
+}
+
 // ─── Agents ──────────────────────────────────────────────────────────────────
 
 registry.registerPath({