@proxima-nexus/openapi 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to the Proxima Nexus OpenAPI specification are documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.0] - 2026-08-12
+
+### Added
+
+- **Transfer group ownership**
+  - `PUT /group/{groupId}/owner/{userId}`: transfers ownership to an existing admin and demotes the current owner to admin. Only the current owner may call it; the target must already be an active admin.
+
 ## [2.5.0] - 2026-08-12
 
 ### Added

package/openapi.json

@@ -187,6 +187,33 @@
         ]
       }
     },
+    "/user/count": {
+      "get": {
+        "operationId": "UserController_count",
+        "summary": "Count users in the tenant",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "Count returned",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityCountDto"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "user"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/user/{userId}": {
       "get": {
         "operationId": "UserController_get",
@@ -928,6 +955,33 @@
         ]
       }
     },
+    "/event/count": {
+      "get": {
+        "operationId": "EventController_count",
+        "summary": "Count events in the tenant",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "Count returned",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityCountDto"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "event"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/event/{eventId}": {
       "get": {
         "operationId": "EventController_get",
@@ -1492,6 +1546,33 @@
         ]
       }
     },
+    "/group/count": {
+      "get": {
+        "operationId": "GroupController_count",
+        "summary": "Count groups in the tenant",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "Count returned",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityCountDto"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "group"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/group/{groupId}": {
       "get": {
         "operationId": "GroupController_get",
@@ -1752,6 +1833,62 @@
         ]
       }
     },
+    "/group/{groupId}/owner/{userId}": {
+      "put": {
+        "operationId": "GroupController_transferOwnership",
+        "summary": "Transfer group ownership to an admin",
+        "description": "Transfers ownership to :userId (who must already be an active admin) and demotes the current owner to admin. Only the current owner may perform this.",
+        "parameters": [
+          {
+            "name": "groupId",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "userId",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Proxima-Nexus-Requester-User-Id",
+            "in": "header",
+            "description": "ID of the current owner transferring ownership",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Ownership transferred"
+          },
+          "400": {
+            "description": "New owner is not an admin, or transfer target is invalid"
+          },
+          "401": {
+            "description": "Only the group owner can transfer ownership"
+          },
+          "404": {
+            "description": "Group not found"
+          }
+        },
+        "tags": [
+          "group"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/group/{groupId}/connections": {
       "get": {
         "operationId": "GroupController_getConnections",
@@ -2533,6 +2670,19 @@
           "birthDate"
         ]
       },
+      "EntityCountDto": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "number",
+            "description": "Number of entities in the tenant",
+            "example": 1234
+          }
+        },
+        "required": [
+          "count"
+        ]
+      },
       "UpdateUserDto": {
         "type": "object",
         "properties": {

package/openapi.yaml

@@ -128,6 +128,22 @@ paths:
         - user
       security:
         - api_key: []
+  /user/count:
+    get:
+      operationId: UserController_count
+      summary: Count users in the tenant
+      parameters: []
+      responses:
+        '200':
+          description: Count returned
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EntityCountDto'
+      tags:
+        - user
+      security:
+        - api_key: []
   /user/{userId}:
     get:
       operationId: UserController_get
@@ -616,6 +632,22 @@ paths:
         - event
       security:
         - api_key: []
+  /event/count:
+    get:
+      operationId: EventController_count
+      summary: Count events in the tenant
+      parameters: []
+      responses:
+        '200':
+          description: Count returned
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EntityCountDto'
+      tags:
+        - event
+      security:
+        - api_key: []
   /event/{eventId}:
     get:
       operationId: EventController_get
@@ -980,6 +1012,22 @@ paths:
         - group
       security:
         - api_key: []
+  /group/count:
+    get:
+      operationId: GroupController_count
+      summary: Count groups in the tenant
+      parameters: []
+      responses:
+        '200':
+          description: Count returned
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EntityCountDto'
+      tags:
+        - group
+      security:
+        - api_key: []
   /group/{groupId}:
     get:
       operationId: GroupController_get
@@ -1140,6 +1188,43 @@ paths:
         - group
       security:
         - api_key: []
+  /group/{groupId}/owner/{userId}:
+    put:
+      operationId: GroupController_transferOwnership
+      summary: Transfer group ownership to an admin
+      description: >-
+        Transfers ownership to :userId (who must already be an active admin) and demotes the current owner to admin.
+        Only the current owner may perform this.
+      parameters:
+        - name: groupId
+          required: true
+          in: path
+          schema:
+            type: string
+        - name: userId
+          required: true
+          in: path
+          schema:
+            type: string
+        - name: X-Proxima-Nexus-Requester-User-Id
+          in: header
+          description: ID of the current owner transferring ownership
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Ownership transferred
+        '400':
+          description: New owner is not an admin, or transfer target is invalid
+        '401':
+          description: Only the group owner can transfer ownership
+        '404':
+          description: Group not found
+      tags:
+        - group
+      security:
+        - api_key: []
   /group/{groupId}/connections:
     get:
       operationId: GroupController_getConnections
@@ -1665,6 +1750,15 @@ components:
       required:
         - gender
         - birthDate
+    EntityCountDto:
+      type: object
+      properties:
+        count:
+          type: number
+          description: Number of entities in the tenant
+          example: 1234
+      required:
+        - count
     UpdateUserDto:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@proxima-nexus/openapi",
-    "version": "2.5.0",
+    "version": "2.7.0",
     "description": "OpenAPI specification for Proxima Nexus",
     "main": "openapi.json",
     "types": "openapi.json",