Add root /api/ endpoint to REST spec (#1312)

jupyter-server · Aug 12, 2023 · c083309 · c083309
1 parent c5dc0f6
commit c083309
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/jupyter_server/services/api/api.yaml b/jupyter_server/services/api/api.yaml
@@ -63,6 +63,22 @@ parameters:
     type: string
 
 paths:
+  /api/:
+    get:
+      summary: Get the Jupyter Server version
+      description: |
+        This endpoint returns only the Jupyter Server version.
+        It does not require any authentication.
+      responses:
+        200:
+          description: Jupyter Server version information
+          schema:
+            type: object
+            properties:
+              version:
+                type: string
+                description: The Jupyter Server version number as a string.
+
   /api/contents/{path}:
     parameters:
       - $ref: "#/parameters/path"