---
title: "Update a dispatch (v2)"
method: PUT
path: "/v2/dispatches"
---

# Update a dispatch (v2)

`PUT /v2/dispatches`

## Request body

- object
  - `id` integer, required — Specify the ID of the dispatch that you want to update. NOTE: You must provide either the dispatch ID or the vendor_id in order to update the dispatch.
  - `vendor_id` integer, required — Specify the ID of the vendor for which you want to update the dispatch info. NOTE: You must provide either the dispatch ID or the vendor ID in order to update the dispatch.
  - `status` string, required — Specify the status of the dispatch that you want to update. Allowed values are: active, completed, cancelled.

## Response `200`

200

- object
  - `dispatches` object[]
    - `dispatch` object
      - `id` integer
      - `vendor_id` string
      - `vendor_shipper_id` string
      - `vendor_consignee_id` string
      - `driver_id` integer
      - `vehicle_id` integer
      - `additional_drops` integer
      - `additional_pickups` integer
      - `consignee_bill_of_lading` string
      - `consignee_comments` string
      - `consignee_driver_load` boolean
      - `consignee_form_ids` string[]
      - `consignee_pallets` integer
      - `consignee_pieces` integer
      - `consignee_refno` string
      - `consignee_status` string
      - `consignee_type` string
      - `consignee_volume` unknown
      - `consignee_weight` integer
      - `delivery_early_date` unknown
      - `delivery_late_date` unknown
      - `loaded_miles` integer
      - `order_pieces` unknown
      - `order_volume` unknown
      - `order_weight` unknown
      - `pickup_early_date` unknown
      - `pickup_late_date` unknown
      - `pickup_number` string
      - `product` string
      - `shipper_bill_of_lading` string
      - `shipper_comments` string
      - `shipper_driver_load` boolean
      - `shipper_form_ids` string[]
      - `shipper_pallets` integer
      - `shipper_pieces` integer
      - `shipper_status` string
      - `shipper_type` string
      - `shipper_volume` unknown
      - `shipper_weight` integer
      - `status` string
      - `temperature_max` integer
      - `temperature_min` integer
      - `trailer` string
      - `shipper_dispatch_location_id` integer
      - `consignee_dispatch_location_id` integer
      - `vendor_shipper_dispatch_location_id` string
      - `vendor_consignee_dispatch_location_id` string
      - `custom_field1` unknown
      - `custom_field2` unknown
      - `custom_field3` unknown
      - `custom_field4` unknown
      - `custom_field5` unknown
      - `custom_field6` unknown
      - `custom_field7` unknown
      - `custom_field8` unknown
      - `custom_field9` unknown
      - `custom_field10` unknown
      - `shipper_custom_field1` unknown
      - `shipper_custom_field2` unknown
      - `shipper_custom_field3` unknown
      - `shipper_custom_field4` unknown
      - `shipper_custom_field5` unknown
      - `shipper_custom_field6` unknown
      - `shipper_custom_field7` unknown
      - `shipper_custom_field8` unknown
      - `shipper_custom_field9` unknown
      - `shipper_custom_field10` unknown
      - `consignee_custom_field1` unknown
      - `consignee_custom_field2` unknown
      - `consignee_custom_field3` unknown
      - `consignee_custom_field4` unknown
      - `consignee_custom_field5` unknown
      - `consignee_custom_field6` unknown
      - `consignee_custom_field7` unknown
      - `consignee_custom_field8` unknown
      - `consignee_custom_field9` unknown
      - `consignee_custom_field10` unknown
      - `dispatch_stops` object[]
        - `dispatch_stop` object
          - `id` integer
          - `vendor_id` string
          - `bill_of_lading` unknown
          - `comments` unknown
          - `driver_load` boolean
          - `early_date` string
          - `form_ids` string[]
          - `late_date` unknown
          - `number` integer
          - `pallets_in` unknown
          - `pallets_out` unknown
          - `pieces` unknown
          - `status` string
          - `type` string
          - `volume` unknown
          - `weight` unknown
          - `custom_field1` unknown
          - `custom_field2` unknown
          - `custom_field3` unknown
          - `custom_field4` unknown
          - `custom_field5` unknown
          - `custom_field6` unknown
          - `custom_field7` unknown
          - `custom_field8` unknown
          - `custom_field9` unknown
          - `custom_field10` unknown
          - `dispatch_location_id` integer
          - `vendor_dispatch_location_id` string
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/versions/c71780e497f5/schema)