/users:
  get:
    tags:
      - User
    summary: "List Users"
    description: "List all Users"
    operationId: listUsers
    parameters:
      - $ref: "#/components/parameters/after"
    responses:
      "404":
        description: "Not Found"
      "200":
        description: "OK"
        headers:
          Pagination-Next:
            $ref: "#/components/headers/PaginationNext"
          Link:
            $ref: "#/components/headers/Link"
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: "#/components/schemas/UserAttributes"
            example:
              <%= FactoryBot.get_examples(:user, version: @version) %>
/users/{id}:
  get:
    tags:
      - User
    summary: "Fetch User"
    description: "Fetch a single User"
    operationId: fetchUser
    parameters:
      - $ref: "#/components/parameters/id"
    responses:
      "404":
        description: "Not Found"
      "200":
        description: "OK"
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UserAttributes"
            example:
              <%= FactoryBot.get_example(:user, version: @version) %>
  put:
    tags:
      - User
    summary: "Update User"
    description: "Update a single User"
    operationId: updateUser
    parameters:
      - $ref: "#/components/parameters/id"
    requestBody:
      description: "Information about updated fields in User"
      required: true
      content:
        application/json:
          schema:
            type: object
            properties:
              user:
                type: object
                $ref: "#/components/schemas/UserParametersUpdate"
          example:
            <%= FactoryBot.put_parameters(:user, version: @version) %>
    responses:
      "404":
        description: "Not Found"
      "200":
        description: "OK"
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/UserAttributes"
            example:
              <%= FactoryBot.put_example(:user, version: @version) %>