/dispatches

This API only accepts a JSON object in the body of the request and is used to update an existing dispatch. The JSON object should take the following general form. Let's assume there is a dispatch with no stops and no trips. If we PUT request the following JSON, we'll get the response above.

{
  "vendor_id":"VD-1",
  "dispatch_stops":[
    {
      "vendor_id":"VBS-2",
      "type":"delivery",
      "number":1,
      "form_ids":[
        "be4cd651-5aca-436b-8cf3-e7881c3d76b8",
        "e93b8563-53cc-4318-b957-369b5fda18d0"
      ],
      "dispatch_location_id":8387
    }
  ],
  "dispatch_trips":[
    {
      "vendor_id":"VT-2",
      "vehicle_id":2597,
      "driver_id":4806,
      "vendor_stop_ids":[
        "VSS-1",
        "VBS-2",
        "VDS-1"
      ],
      "status":"not_started"
    }
  ]
}

To update an existing dispatch just send the entire dispatch again with updated information to this API. To remove a dispatch stop or trip (additional stop/trip) just send the entire dispatch again without the information for the dispatch stop/trip created before. You can simply pass a {vendor_id: XYZ} for a dispatch stop/trip in the dispatch trips/stops array to persist the trip/stop through API calls.