ref: crud organization members

Author: jianyuan

internal/apiclient/api.yaml

@@ -37,10 +37,11 @@ paths:
   /0/organizations/{organization_id_or_slug}/members/:
     parameters:
       - $ref: "#/components/parameters/organization_id_or_slug"
-      - $ref: "#/components/parameters/cursor"
     get:
       summary: List Organization Members
       operationId: listOrganizationMembers
+      parameters:
+        - $ref: "#/components/parameters/cursor"
       responses:
         "200":
           description: OK
@@ -56,6 +57,99 @@ paths:
           description: Forbidden
         "404":
           description: Not Found
+    post:
+      summary: Create an Organization Member
+      operationId: createOrganizationMember
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - email
+                - orgRole
+              properties:
+                email:
+                  type: string
+                orgRole:
+                  type: string
+                teams:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        "201":
+          description: Created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/OrganizationMember"
+        "401":
+          description: Unauthorized
+        "403":
+          description: Forbidden
+  /0/organizations/{organization_id_or_slug}/members/{member_id}/:
+    parameters:
+      - $ref: "#/components/parameters/organization_id_or_slug"
+      - $ref: "#/components/parameters/member_id"
+    get:
+      summary: Retrieve an Organization Member
+      operationId: getOrganizationMember
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/OrganizationMemberWithRoles"
+        "401":
+          description: Unauthorized
+        "403":
+          description: Forbidden
+        "404":
+          description: Not Found
+    put:
+      summary: Update an Organization Member
+      operationId: updateOrganizationMember
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                orgRole:
+                  type: string
+                teamRoles:
+                  type: array
+                  items:
+                    $ref: "#/components/schemas/TeamRole"
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/OrganizationMemberWithRoles"
+        "401":
+          description: Unauthorized
+        "403":
+          description: Forbidden
+        "404":
+          description: Not Found
+    delete:
+      summary: Delete an Organization Member
+      operationId: deleteOrganizationMember
+      responses:
+        "204":
+          description: No Content
+        "401":
+          description: Unauthorized
+        "403":
+          description: Forbidden
+        "404":
+          description: Not Found
   /0/organizations/{organization_id_or_slug}/projects/:
     parameters:
       - $ref: "#/components/parameters/organization_id_or_slug"
@@ -670,6 +764,12 @@ components:
       required: true
       schema:
         type: string
+    member_id:
+      name: member_id
+      in: path
+      required: true
+      schema:
+        type: string
     cursor:
       name: cursor
       in: query
@@ -683,19 +783,31 @@ components:
         - id
         - name
         - slug
+        - orgRoleList
+        - teamRoleList
       properties:
         id:
           type: string
         name:
           type: string
         slug:
           type: string
+        orgRoleList:
+          type: array
+          items:
+            $ref: "#/components/schemas/OrganizationRoleListItem"
+        teamRoleList:
+          type: array
+          items:
+            $ref: "#/components/schemas/TeamRoleListItem"
     OrganizationMember:
       type: object
       required:
         - id
         - email
         - name
+        - pending
+        - expired
         - orgRole
       properties:
         id:
@@ -704,8 +816,115 @@ components:
           type: string
         name:
           type: string
+        pending:
+          type: boolean
+        expired:
+          type: boolean
         orgRole:
           type: string
+    OrganizationRoleListItem:
+      type: object
+      required:
+        - id
+        - name
+        - desc
+        - scopes
+        - isAllowed
+        - isRetired
+        - isGlobal
+        - minimumTeamRole
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        desc:
+          type: string
+        scopes:
+          type: array
+          items:
+            type: string
+        isAllowed:
+          type: boolean
+        isRetired:
+          type: boolean
+        isGlobal:
+          type: boolean
+        minimumTeamRole:
+          type: string
+    TeamRoleListItem:
+      type: object
+      required:
+        - id
+        - name
+        - desc
+        - scopes
+        - isAllowed
+        - isRetired
+        - isMinimumRoleFor
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        desc:
+          type: string
+        scopes:
+          type: array
+          items:
+            type: string
+        isAllowed:
+          type: boolean
+        isRetired:
+          type: boolean
+        isMinimumRoleFor:
+          type: string
+    TeamRole:
+      type: object
+      required:
+        - teamSlug
+      properties:
+        teamSlug:
+          type: string
+        role:
+          type: string
+    OrganizationMemberWithRoles:
+      type: object
+      required:
+        - id
+        - email
+        - name
+        - pending
+        - expired
+        - orgRole
+        - orgRoleList
+        - teamRoles
+        - teamRoleList
+      properties:
+        id:
+          type: string
+        email:
+          type: string
+        name:
+          type: string
+        pending:
+          type: boolean
+        expired:
+          type: boolean
+        orgRole:
+          type: string
+        orgRoleList:
+          type: array
+          items:
+            $ref: "#/components/schemas/OrganizationRoleListItem"
+        teamRoles:
+          type: array
+          items:
+            $ref: "#/components/schemas/TeamRole"
+        teamRoleList:
+          type: array
+          items:
+            $ref: "#/components/schemas/TeamRoleListItem"
     Project:
       type: object
       required: