Merge branch 'resolves_issue_37' into 'master'

Resolves issue 37

Closes #37

See merge request !88

docs/swagger.yml

@@ -6,7 +6,7 @@ swagger: '2.0'
 info:
   title: Oracle Functions
   description: The open source serverless platform.
-  version: "0.1.33"
+  version: "0.1.34"
 # the domain of the service
 host: "127.0.0.1:8080"
 # array of all schemes that your API supports
@@ -161,7 +161,7 @@ paths:
   /apps/{app}/routes:
     post:
       summary: Create new Route
-      description: Create a new route in an app, if app doesn't exists, it creates the app
+      description: Create a new route in an app, if app doesn't exists, it creates the app. Post does not skip validation of zero values.
       tags:
         - Routes
       parameters:
@@ -220,8 +220,43 @@ paths:
             $ref: '#/definitions/Error'
 
   /apps/{app}/routes/{route}:
+    put:
+      summary: Create a Route if it does not exist. Update if it does. Will also create app if it does not exist. Put does not skip validation of zero values
+      description: Update or Create a route
+      tags:
+        - Routes
+      parameters:
+        - name: app
+          in: path
+          description: name of the app.
+          required: true
+          type: string
+        - name: route
+          in: path
+          description: route path.
+          required: true
+          type: string
+        - name: body
+          in: body
+          description: One route to post.
+          required: true
+          schema:
+            $ref: '#/definitions/RouteWrapper'
+      responses:
+        200:
+          description: Route created or updated
+          schema:
+            $ref: '#/definitions/RouteWrapper'
+        400:
+          description: Invalid route due to parameters being missing or invalid.
+          schema:
+            $ref: '#/definitions/Error'
+        default:
+          description: Unexpected error
+          schema:
+            $ref: '#/definitions/Error'
     patch:
-      summary: Update a Route
+      summary: Update a Route, Fails if the route or app does not exist. Accepts partial updates / skips validation of zero values.
       description: Update a route
       tags:
         - Routes
@@ -252,7 +287,7 @@ paths:
           schema:
             $ref: '#/definitions/Error'
         404:
-          description: App does not exist.
+          description: App / Route does not exist.
           schema:
             $ref: '#/definitions/Error'
         default: