@proxima-nexus/openapi 2.5.0 → 2.6.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

@@ -1752,6 +1752,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",

package/openapi.yaml

@@ -1140,6 +1140,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

package/package.json

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