update swagger.yaml

api/swagger/swagger.yaml

@@ -65,12 +65,32 @@ paths:
           description: Error
           schema:
             $ref: "#/definitions/ErrorResponse"
+  /garages:
+    # binds app logic to a route (api/controllers/applications.js)
+    x-swagger-router-controller: garages
+    get:
+      description: Returns a list of garages to the caller
+      # used as the method name of the controller inside garages.js
+      operationId: garages
+      responses:
+        "200":
+          description: Success
+          schema:
+            type: array
+            items:
+              # a pointer to a definition
+              $ref: "#/definitions/Garage"
+        # responses may fall through to errors
+        default:
+          description: Error
+          schema:
+            $ref: "#/definitions/ErrorResponse"
   /garages/{garageId}:
     # Use the house address as the garageId
     # binds app logic to a route (api/controllers/garages.js)
     x-swagger-router-controller: garages
     get:
-      description: Returns a single garage configurations to the caller
+      description: Returns a single garage configuration to the caller
       # used as the method name of the controller inside garages.js
       operationId: garages
       parameters:
@@ -125,6 +145,18 @@ definitions:
         type: string
       status:
         type: string
+  Garage:
+    properties:
+      garageId:
+        type: string
+      name:
+        type: string
+      description:
+        type: string
+      desiredState:
+        type: string
+      status:
+        type: string
   ErrorResponse:
     required:
       - message