get:
  operationId: UserGroupGet
  tags:
    - User Groups
  summary: Get user group
  parameters:
    - name: name
      in: path
      description: group name
      required: true
      schema:
        type: string
  responses:
    200:
      description: Successful Operation
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                $ref: ../components/schemas/UserGroup.yaml
    400:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: ../components/schemas/ErrorPayload.yaml
put:
  operationId: UserGroupPut
  tags:
    - User Groups
  summary: Update user group
  parameters:
    - name: name
      in: path
      description: group name
      required: true
      schema:
        type: string
  requestBody:
    content:
      application/json:
        schema:
          $ref: ../components/schemas/UserGroup.yaml
    required: true
  responses:
    200:
      description: Successful Operation
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                $ref: ../components/schemas/UserGroup.yaml
    400:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: ../components/schemas/ErrorPayload.yaml
delete:
  operationId: UserGroupDelete
  tags:
    - User Groups
  summary: Delete user group
  description: Delete user gruop, any member users will be removed from the group.
  parameters:
    - name: name
      in: path
      description: group name
      required: true
      schema:
        type: string
  responses:
    204:
      description: Successful Operation
    400:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: ../components/schemas/ErrorPayload.yaml