Iss #7 - Add council members endpoint to API

• Iss #7 (closed) - Add council members endpoint to API

spec/openapi.yaml

@@ -181,3 +181,60 @@ components:
               type: string
               description: The human readable name for the relation
               example: Board Representative - Belgium
+
+    CouncilMembers:
+      type: array
+      items:
+        $ref: "#/components/schemas/CouncilMember"
+        
+    CouncilMember:
+      type: object
+      required:
+        - first_name
+        - last_name
+        - relation
+        - person_id
+        - comment
+        - mentor_for_projects
+        - is_chair
+      properties:
+        person_id:
+          type: string
+          description: Username of the council member
+        first_name:
+          type: string
+          description: First name of the council member
+        last_name:
+          type: string
+          description: The last name of the council member
+        org_name:
+          type: 
+            - string
+            - 'null'
+          description: The name of the organisation this council member represents, if set
+        org_id:
+          type: 
+            - number
+            - 'null'
+          description: Numeric ID of the organisation the council member belongs to
+        comment:
+          type: string
+          description: The comment associated with the relationship, such as appointed year or relation to the council.
+        mentor_for_projects:
+          type: array
+          description: List of projects that the council member is a mentor for, if any
+          items: 
+            type: string
+        is_chair:
+          type: boolean
+          description: True if the member in question is a chair for the current council.
+        relation:
+          type: object
+          properties:
+            code:
+              type: string
+              description: The relation code for the board member
+            description:
+              type: string
+              description: The human readable name for the relation
+