swagger: '2.0'
info:
  title: Responses
  version: 0.1.0
definitions:
  Error:
    type: object
    description: |
      Contains all the properties any error response from the API will contain.
      Some properties are optional so might be empty most of the time
    required:
      - code
      - message
    properties:
      code:
        description: the error code, this is not necessarily the http status code
        type: integer
        format: int32
      message:
        description: a human readable version of the error
        type: string
      helpUrl:
        description: an optional url for getting more help about this error
        type: string
        format: uri

responses:
  BadRequest:
    description: Bad request
    schema:
      $ref: '#/definitions/Error'

paths:
  /:
    get:
      summary: GET
      operationId: getAll
      responses:
        200:
          description: Ok