api: add /info endpoint (#945) (#5045)

2025-09-30 10:39:27 +02:00
parent 2024783eec
commit 2690ef8e71
10 changed files with 113 additions and 33 deletions
@@ -21,6 +21,14 @@ components:
        error:
          type: string

+    Info:
+      type: object
+      properties:
+        version:
+          type: string
+        started:
+          type: string
+
    AuthInternalUser:
      type: object
      properties:
@@ -1134,6 +1142,25 @@ components:

 paths:

+  /v3/info:
+    get:
+      operationId: info
+      tags: [General]
+      summary: returns informations about the instance.
+      responses:
+        '200':
+          description: the request was successful.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Info'
+        '500':
+          description: server error.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
  /v3/auth/jwks/refresh:
    post:
      operationId: authJwksRefresh