Update video openapi Spec

openapi/video-openapi-clientside.yaml

@@ -3948,6 +3948,76 @@ components:
       - duration
       title: JoinCallResponse
       type: object
+    KickUserRequest:
+      description: KickUserRequest is the payload for kicking a user from a call.
+        Optionally block the user as well.
+      nullable: true
+      properties:
+        block:
+          description: If true, also block the user from rejoining the call
+          title: Block
+          type: boolean
+          x-stream-index: "004"
+        user_id:
+          description: The user to kick
+          title: UserID
+          type: string
+          x-stream-index: "003"
+      required:
+      - user_id
+      title: KickUserRequest
+      type: object
+    KickUserResponse:
+      description: KickUserResponse is the payload for kicking a user from a call.
+      nullable: true
+      properties:
+        duration:
+          description: Duration of the request in milliseconds
+          title: Duration
+          type: string
+          x-stream-index: "001.001"
+      required:
+      - duration
+      title: KickUserResponse
+      type: object
+    KickedUserEvent:
+      description: This event is sent to call participants to notify when a user is
+        kicked from a call. Clients should make the kicked user leave the call UI.
+      properties:
+        call_cid:
+          type: string
+          x-stream-index: "002.001"
+        created_at:
+          format: date-time
+          type: string
+          x-stream-index: "001.002"
+        kicked_by_user:
+          $ref: '#/components/schemas/UserResponse'
+          description: The user that kicked the participant, null if server-side
+          title: Kicked by
+          x-stream-index: "004"
+        type:
+          default: call.kicked_user
+          description: 'The type of event: "call.kicked_user" in this case'
+          title: Event Type
+          type: string
+          x-stream-index: "001.001"
+        user:
+          $ref: '#/components/schemas/UserResponse'
+          description: The user that was kicked
+          title: User
+          x-stream-index: "003"
+      required:
+      - type
+      - created_at
+      - call_cid
+      - user
+      title: KickedUserEvent
+      type: object
+      x-stream-event-call-type: true
+      x-stream-event-doc-group: call
+      x-stream-is-event: true
+      x-stream-ws-base-event-name: VideoEvent
     LayoutSettingsRequest:
       properties:
         detect_orientation:
@@ -4232,6 +4302,7 @@ components:
       - join-backstage
       - join-call
       - join-ended-call
+      - kick-user
       - mute-users
       - pin-for-everyone
       - read-call
@@ -6771,6 +6842,7 @@ components:
           call.hls_broadcasting_failed: '#/components/schemas/CallHLSBroadcastingFailedEvent'
           call.hls_broadcasting_started: '#/components/schemas/CallHLSBroadcastingStartedEvent'
           call.hls_broadcasting_stopped: '#/components/schemas/CallHLSBroadcastingStoppedEvent'
+          call.kicked_user: '#/components/schemas/KickedUserEvent'
           call.live_started: '#/components/schemas/CallLiveStartedEvent'
           call.member_added: '#/components/schemas/CallMemberAddedEvent'
           call.member_removed: '#/components/schemas/CallMemberRemovedEvent'
@@ -6870,6 +6942,7 @@ components:
       - $ref: '#/components/schemas/ConnectionErrorEvent'
       - $ref: '#/components/schemas/CustomVideoEvent'
       - $ref: '#/components/schemas/HealthCheckEvent'
+      - $ref: '#/components/schemas/KickedUserEvent'
       - $ref: '#/components/schemas/PermissionRequestEvent'
       - $ref: '#/components/schemas/UnblockedUserEvent'
       - $ref: '#/components/schemas/UpdatedCallPermissionsEvent'
@@ -7010,7 +7083,7 @@ components:
       type: apiKey
 info:
   title: Stream API
-  version: v187.13.0
+  version: v190.7.0
 openapi: 3.0.3
 paths:
   /video/call/{type}/{id}:
@@ -7740,6 +7813,65 @@ paths:
       summary: Join call
       tags:
       - product:video
+  /video/call/{type}/{id}/kick:
+    post:
+      description: |
+        Kicks a user from the call. Optionally block the user from rejoining by setting block=true.
+
+        Sends events:
+        - call.blocked_user
+        - call.kicked_user
+      operationId: KickUser
+      parameters:
+      - in: path
+        name: type
+        required: true
+        schema:
+          description: The type of call
+          maxLength: 64
+          title: Type
+          type: string
+          writeOnly: true
+          x-stream-index: "002.001"
+      - in: path
+        name: id
+        required: true
+        schema:
+          description: Call ID
+          maxLength: 64
+          title: ID
+          type: string
+          writeOnly: true
+          x-stream-index: "002.002"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/KickUserRequest'
+        description: KickUserRequest
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/KickUserResponse'
+          description: KickUserResponse
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIError'
+          description: Bad request
+        "429":
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIError'
+          description: Too many requests
+      summary: Kick user from a call
+      tags:
+      - product:video
   /video/call/{type}/{id}/mark_ended:
     post:
       description: |2