openapi: replace participantName with participantIdentity in API parameters and improve updateParticipant endpoint

backend/openapi/components/parameters/internal/participant-identity.yaml

@@ -0,0 +1,7 @@
+name: participantIdentity
+in: path
+required: true
+description: The identity of the participant.
+schema:
+    type: string
+example: 'Alice'

backend/openapi/components/parameters/internal/participant-name.yaml

@@ -1,7 +0,0 @@
-name: participantName
-in: path
-required: true
-description: The name of the participant.
-schema:
-    type: string
-example: 'Alice'

backend/openapi/components/requestBodies/internal/update-participant-request.yaml

@@ -0,0 +1,12 @@
+description: Update participant role
+required: true
+content:
+    application/json:
+        schema:
+            type: object
+            properties:
+                role:
+                    type: string
+                    enum: ['moderator', 'speaker']
+                    description: The new role to assign to the participant.
+                    example: 'moderator'

backend/openapi/components/responses/internal/success-update-participant.yaml

@@ -6,4 +6,4 @@ content:
             properties:
                 message:
                     type: string
-                    example: 'Participant "123" role updated to "moderator"'
+                    example: 'Participant "Alice" role updated to "moderator"'

backend/openapi/openvidu-meet-internal-api.yaml

@@ -46,8 +46,8 @@ paths:
         $ref: './paths/internal/participants.yaml#/~1participants~1token~1refresh'
     /meetings/{roomId}:
         $ref: './paths/internal/meetings.yaml#/~1meetings~1{roomId}'
-    /meetings/{roomId}/participants/{participantName}:
-        $ref: './paths/internal/meetings.yaml#/~1meetings~1{roomId}~1participants~1{participantName}'
+    /meetings/{roomId}/participants/{participantIdentity}:
+        $ref: './paths/internal/meetings.yaml#/~1meetings~1{roomId}~1participants~1{participantIdentity}'
 
 components:
     securitySchemes:

backend/openapi/paths/internal/meetings.yaml

@@ -26,9 +26,38 @@
                 $ref: '../../components/responses/error-room-not-found.yaml'
             '500':
                 $ref: '../../components/responses/internal-server-error.yaml'
-/meetings/{roomId}/participants/{participantName}:
+/meetings/{roomId}/participants/{participantIdentity}:
+    patch:
+        operationId: updateParticipant
+        summary: Update participant in a meeting
+        description: >
+            Updates the properties of a participant in the current meeting in an OpenVidu Meet room.
+            This can be used to change the participant role.
+        tags:
+            - Internal API - Meetings
+        security:
+            - participantTokenCookie: []
+        parameters:
+            - $ref: '../../components/parameters/room-id-path.yaml'
+            - $ref: '../../components/parameters/internal/participant-identity.yaml'
+            - $ref: '../../components/parameters/internal/x-participant-role.yaml'
+        requestBody:
+            $ref: '../../components/requestBodies/internal/update-participant-request.yaml'
+        responses:
+            '200':
+                $ref: '../../components/responses/internal/success-update-participant.yaml'
+            '400':
+                $ref: '../../components/responses/internal/error-invalid-participant-role.yaml'
+            '401':
+                $ref: '../../components/responses/unauthorized-error.yaml'
+            '403':
+                $ref: '../../components/responses/forbidden-error.yaml'
+            '404':
+                $ref: '../../components/responses/internal/error-room-participant-not-found.yaml'
+            '500':
+                $ref: '../../components/responses/internal-server-error.yaml'
     delete:
-        operationId: disconnectParticipant
+        operationId: kickParticipant
         summary: Kick a participant from a meeting
         description: >
             Kicks a participant from the current meeting in an OpenVidu Meet room.
@@ -38,7 +67,7 @@
             - participantTokenCookie: []
         parameters:
             - $ref: '../../components/parameters/room-id-path.yaml'
-            - $ref: '../../components/parameters/internal/participant-name.yaml'
+            - $ref: '../../components/parameters/internal/participant-identity.yaml'
             - $ref: '../../components/parameters/internal/x-participant-role.yaml'
         responses:
             '200':
@@ -53,42 +82,4 @@
                 $ref: '../../components/responses/internal/error-room-participant-not-found.yaml'
             '500':
                 $ref: '../../components/responses/internal-server-error.yaml'
-    patch:
-        operationId: updateParticipant
-        summary: Update participant in a meeting
-        description: >
-            Updates the properties of a participant in the current meeting in an OpenVidu Meet room.
-            This can be used to change the participant role.
-        tags:
-            - Internal API - Meetings
-        security:
-            - participantTokenCookie: []
-        parameters:
-            - $ref: '../../components/parameters/room-id-path.yaml'
-            - $ref: '../../components/parameters/internal/participant-name.yaml'
-            # - $ref: '../../components/parameters/internal/x-participant-role.yaml'
-        requestBody:
-            required: true
-            content:
-                application/json:
-                    schema:
-                        type: object
-                        properties:
-                            role:
-                                type: string
-                                enum: [MODERATOR, SPEAKER]
-                                description: The new role for the participant.
-        responses:
-            '200':
-                $ref: '../../components/responses/internal/success-update-participant.yaml'
-            '400':
-                $ref: '../../components/responses/internal/error-invalid-participant-role.yaml'
-            '401':
-                $ref: '../../components/responses/unauthorized-error.yaml'
-            '403':
-                $ref: '../../components/responses/forbidden-error.yaml'
-            '404':
-                $ref: '../../components/responses/internal/error-room-participant-not-found.yaml'
-            '500':
-                $ref: '../../components/responses/internal-server-error.yaml'