# NOTE: Do not upgrade past Swagger 2. zclient does not support OpenAPI 3 unless
# https://github.com/Yelp/bravado/issues/306 is resolved.
swagger: "2.0"
info:
  description: "{{ cookiecutter.project_description }}"
  version: "{{ cookiecutter.project_version }}"
  title: "{{ cookiecutter.project_name }}"
  contact:
    name: "{{ cookiecutter.author}}"
    email: "{{ cookiecutter.author_email }}"
    url: "{{ cookiecutter.project_url }}"
# Your API spec goes here.  https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
basePath: /v1
paths:
  /foos:
    get:
      summary: "get"
      # This operationId maps to a method in your controller.
      # Note that the name will be converted from camelCase here
      # to snake_case in the controller.
      operationId: "getFoos"
      produces:
        - application/json
      responses:
        "200":
          description: "Got the foos!"
          schema:
            $ref: "#/definitions/FooList"
definitions:
  Foo:
    type: object
    properties:
      bar:
        type: "string"
        description: "Foo's bar."
    required:
      - bar
  FooList:
    type: object
    properties:
      items:
        type: array
        items:
          $ref: "#/definitions/Foo"
    required:
      - items
