api docs: add docs for vehicle patch body

Author: AChelikani

swagger.json

@@ -2070,7 +2070,7 @@
                   "200": {
                       "description": "Returns vehicle.",
                       "schema": {
-                          "$ref": "#/definitions/VehicleResponse"
+                          "$ref": "#/definitions/FleetVehicleResponse"
                       }
                   },
                   "default": {
@@ -2088,6 +2088,29 @@
             ],
             "summary": "/fleet/vehicles/{vehicle_id | external_id}",
             "description": "Updates a vehicle given either a vehicle ID or external ID key:value pair (ex. payroll:1)",
+            "parameters": [
+                {
+                    "in": "body",
+                    "name": "data",
+                    "required": true,
+                    "schema": {
+                        "type": "object",
+                        "properties":
+                        {
+                            "name": {
+                                "description": "Name",
+                                "type": "string"
+                            },
+                            "harsh_accel_setting": {
+                                "description": "Harsh Acceleration Setting\n* 0: Passenger\n* 1: Light Truck\n* 2: Heavy\n* 3: Off\n* 4: Auto",
+                                "type": "integer",
+                                "format": "int64",
+                                "enum": [ 0, 1, 2, 3, 4 ]
+                            }
+                        }
+                    }
+                }
+            ],
             "operationId": "updateVehicle",
             "consumes": [
               "application/json"
@@ -2099,7 +2122,7 @@
               "200": {
                 "description": "Returns updated vehicle.",
                 "schema": {
-                    "$ref": "#/definitions/VehicleResponse"
+                    "$ref": "#/definitions/FleetVehicleResponse"
                 }
               },
               "default": {
@@ -5622,60 +5645,65 @@
                 }
             }
         },
-        "VehicleResponse": {
+        "FleetVehicleResponse": {
             "type": "object",
-            "description": "Contains information about the vehicle",
+            "description": "A vehicle object as returned for fleet/vehicle",
+            "required": [
+                "id",
+                "name"
+            ],
             "properties": {
                 "id": {
                     "type": "integer",
                     "description": "ID of the vehicle.",
                     "format": "int64",
-                    "example": 123
+                    "example": 112
                 },
                 "name": {
                     "type": "string",
-                    "description": "Name of the vehicle",
-                    "format": "string",
-                    "example": "Bob's Truck"
-                },
-                "make": {
-                    "type": "string",
-                    "description": "Make of the vehicle",
-                    "format": "string",
-                    "example": "Toyota"
+                    "description": "Name of the vehicle.",
+                    "example": "Truck A7"
                 },
-                "model": {
-                    "type": "string",
-                    "description": "Model of the vehicle",
-                    "format": "string",
-                    "example": "Corolla"
-                },              
-                "vin": {
-                    "type": "string",
-                    "description": "VIN of the vehicle",
-                    "format": "string",
-                    "example": "1HGBH41JXMN109186"
+                "vehicleInfo": {
+                    "type": "object",
+                    "description": "",
+                    "properties": {
+                        "vin": {
+                            "type": "string",
+                            "description": "Vehicle Identification Number.",
+                            "example": "1FUJA6BD31LJ09646"
+                        },
+                        "make": {
+                            "type": "string",
+                            "description": "Make of the vehicle.",
+                            "example": "Honda"
+                        },
+                        "model": {
+                            "type": "string",
+                            "description": "Model of the Vehicle.",
+                            "example": "Odyssey"
+                        },
+                        "year": {
+                            "type": "integer",
+                            "format": "int64",
+                            "description": "Year of the vehicle.",
+                            "example": 1997
+                        }
+                    }
                 },
-                "year": {
-                    "type": "integer",
-                    "description": "Year the vehicle was made.",
-                    "format": "int64",
-                    "example": "2017"
-                },     
                 "harshAccelSetting": {
                     "type": "integer",
-                    "description": "A number from 1-10 indicating the harsh acceleration setting of the vehicle",
                     "format": "int64",
-                    "example": "2017"
-                },                            
-                "externalIds" : {
+                    "description": "Harsh acceleration setting.",
+                    "example": 1
+                },
+                "externalIds": {
                     "type": "object",
-                    "description": "Dictionary of external IDs (string key-value pairs)",
                     "additionalProperties": {
-                      "type": "string"
-                    },
-                    "example": {"maintenanceId": "ABFS18600"}
-                  }
+                        "type": "string"
+                      },
+                      "example": {"maintenanceId": "ABFS18600"}
+                }            
             }
         },
         "MachineHistoryResponse": {