v1.yaml

openapi: 3.0.0 
info:
  title: Employees first iteration
  version: 0.0.1
paths:
    /employees:
      get :
        summary: List all employees
        responses:
          200:
            description: Return list of employees
            content:
              application/vnd.company.v1+json:
                schema:
                  type: array 
                  items:
                    $ref: '#/components/schemas/employee'

components:
  schemas:
    employee:
      type: object
      properties:
        id:
          type: number
          example: 12345
          description: Id of the employee 
        email:
          type: string 
          example: jack. sparrow@comapny.com
        full_name:
          type: string 
          example: Jack Sparrow
        department:
          type: string
          example: Jack Sparrowv