feat: add 'users/{userId}/groups/represented' (#262)

* feat: add 'users/{userId}/groups/represented'

I believe I added everything needed, however this is my first time doing things with the OpenAPI spec.

This endpoint can return either an empty object or an object containing some info about the group that's being represented

* Update users.yaml

Im hoping this resolves that issue, if not i'll rework this some more ^^

openapi/components/paths.yaml

@@ -231,6 +231,8 @@
   $ref: "./paths/users.yaml#/paths/~1users~1{userId}~1groups"
 "/users/{userId}/groups/requested":
   $ref: "./paths/users.yaml#/paths/~1users~1{userId}~1groups~1requested"
+"/users/{userId}/groups/represented":
+  $ref: "./paths/users.yaml#/paths/~1users~1{userId}~1groups~1represented"
 
 # worlds
 

openapi/components/paths/users.yaml

@@ -174,6 +174,26 @@ paths:
           $ref: ../responses/MissingCredentialsError.yaml
       security:
         - authCookie: []
+  "/users/{userId}/groups/represented":
+    parameters:
+      - $ref: ../parameters.yaml#/userId
+    get:
+      summary: Get user's current represented group
+      description: Returns the current group that the user is currently representing
+      operationId: getUserRepresentedGroup
+      tags:
+        - users
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: ../schemas/representedGroup.yaml
+        "401":
+          $ref: ../responses/MissingCredentialsError.yaml
+      security:
+        - authCookie: []
 tags:
   $ref: ../tags.yaml
 components:

openapi/components/schemas/representedGroup.yaml

@@ -0,0 +1,35 @@
+title: RepresentedGroup
+type: object
+properties:
+  name:
+    type: string
+  shortCode:
+    $ref: ./GroupShortCode.yaml
+  discriminator:
+    $ref: ./GroupDiscriminator.yaml
+  description:
+    type: string
+  iconId:
+    type: string
+    nullable: true
+  iconUrl:
+    type: string
+    nullable: true
+  bannerId:
+    type: string
+    nullable: true
+  bannerUrl:
+    type: string
+    nullable: true
+  privacy:
+    $ref: ./GroupPrivacy.yaml
+  ownerId:
+    $ref: ./UserID.yaml
+  memberCount:
+    type: integer
+  groupId:
+    $ref: ./GroupID.yaml
+  memberVisibility:
+    $ref: ./GroupUserVisibility.yaml
+  isRepresenting:
+    type: boolean