Add User Group Instances endpoint

openapi/components/paths.yaml

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

openapi/components/paths/users.yaml

@@ -194,6 +194,24 @@ paths:
           $ref: ../responses/MissingCredentialsError.yaml
       security:
         - authCookie: []
+  "/users/{userId}/instances/groups":
+    parameters:
+      - $ref: ../parameters.yaml#/userId
+    get:
+      summary: Get User Group Instances
+      description: Returns a list of group instances for a user
+      operationId: getUserGroupInstances
+      tags:
+        - users
+      responses:
+        '200':
+          $ref: ../responses/users/UserGroupInstanceListResponse.yaml
+        '401':
+          $ref: ../responses/MissingCredentialsError.yaml
+        '403':
+          $ref: ../responses/users/UserMustBeOwnError.yaml
+      security:
+        - authCookie: []
 tags:
   $ref: ../tags.yaml
 components:

openapi/components/responses/users/UserGroupInstanceListResponse.yaml

@@ -0,0 +1,13 @@
+description: Returns a list of Instance objects with a fetched at time.
+content:
+  application/json:
+    schema:
+      type: object
+      properties:
+        fetchedAt:
+          type: string
+          format: date-time
+        instances:
+          type: array
+          items:
+            $ref: ../../schemas/Instance.yaml

openapi/components/responses/users/UserMustBeOwnError.yaml

@@ -0,0 +1,11 @@
+description: Error response when trying get group instances of another user.
+content:
+  application/json:
+    schema:
+      $ref: ../../schemas/Error.yaml
+    examples:
+      User Id must be your own:
+        value:
+          error:
+            message: "User ID must be your own․"
+            status_code: 403