Add new organization endpoints to API reference

backend/src/controllers/v2/usersController.ts

@@ -1,9 +1,16 @@
 import { Request, Response } from 'express';
 import * as Sentry from '@sentry/node';
 import {
-    User
+    User,
+    MembershipOrg
 } from '../../models';
 
+/**
+ * Return the current user.
+ * @param req 
+ * @param res 
+ * @returns 
+ */
 export const getMe = async (req: Request, res: Response) => {
     /* 
     #swagger.summary = "Retrieve the current user on the request"
@@ -39,11 +46,64 @@ export const getMe = async (req: Request, res: Response) => {
         Sentry.setUser({ email: req.user.email });
 		Sentry.captureException(err);
 		return res.status(400).send({
-			message: 'Failed to get user'
+			message: 'Failed to get current user'
 		});
     }
     
     return res.status(200).send({
         user
     });
+}
+
+/**
+ * Return organizations that the current user is part of.
+ * @param req 
+ * @param res 
+ */
+export const getMyOrganizations = async (req: Request, res: Response) => {
+    /* 
+    #swagger.summary = 'Return organizations that current user is part of'
+    #swagger.description = 'Return organizations that current user is part of'
+    
+    #swagger.security = [{
+        "apiKeyAuth": []
+    }]
+
+    #swagger.responses[200] = {
+        content: {
+            "application/json": {
+                "schema": { 
+                    "type": "object",
+					"properties": {
+						"organizations": {
+							"type": "array",
+							"items": {
+								$ref: "#/components/schemas/Organization" 
+							},
+							"description": "Organizations that user is part of"
+						}
+					}
+                }
+            }           
+        }
+    }   
+    */
+	let organizations;
+	try {
+		organizations = (
+			await MembershipOrg.find({
+				user: req.user._id
+			}).populate('organization')
+		).map((m) => m.organization);
+	} catch (err) {
+		Sentry.setUser({ email: req.user.email });
+		Sentry.captureException(err);
+		return res.status(400).send({
+			message: "Failed to get current user's organizations"
+		});
+	}
+
+	return res.status(200).send({
+		organizations
+	});
 }