/api/v1/config/roles:
  description: pf::UnifiedApi::Controller::Config::Roles
  get:
    description: List all items.
    operationId: api.v1.Config.Roles.list
    parameters: []
    responses:
      '200':
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigRolesList'
        description: Request successful. Response contains a list of resources.
      '401':
        $ref: '#/components/responses/Forbidden'
    tags:
    - Config/Roles
  options:
    description: Get meta for a new item.
    operationId: api.v1.Config.Roles.options
    parameters: []
    responses:
      '200':
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigRolesMeta'
        description: Request successful. Response contains meta for a resource.
      '401':
        $ref: '#/components/responses/Forbidden'
      '404':
        $ref: '#/components/responses/NotFound'
    tags:
    - Config/Roles
  post:
    description: Create a new item.
    operationId: api.v1.Config.Roles.create
    parameters: []
    requestBody:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ConfigRole'
    responses:
      '201':
        $ref: '#/components/responses/Created'
      '400':
        $ref: '#/components/responses/BadRequest'
      '401':
        $ref: '#/components/responses/Forbidden'
      '409':
        $ref: '#/components/responses/Duplicate'
      '422':
        $ref: '#/components/responses/UnprocessableEntity'
    tags:
    - Config/Roles
