get:
  summary: 按指定条件列出角色
  parameters:
    - $ref: '../parameters/common.yaml#/offset'
    - $ref: '../parameters/common.yaml#/limit'
    - $ref: '../parameters/common.yaml#/scope'
    - $ref: '../parameters/identity.yaml#/project_domain'
  responses:
    200:
      description: 角色列表信息
      schema:
        $ref: "../schemas/role.yaml#/RoleListResponse"
  tags:
    - roles

post:
  summary: 新建一个角色
  parameters:
    - name: role
      in: body
      required: true
      schema:
        $ref: "../schemas/role.yaml#/RoleCreateInput"
  responses:
    200:
      description: 角色信息
      schema:
        $ref: "../schemas/role.yaml#/RoleGetResponse"
  tags:
    - roles