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

# Update a dispatch (v3)

`PUT /v3/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
  - `dispatch` object
    - `id` integer
    - `additional_drops` unknown
    - `additional_pickups` unknown
    - `loaded_miles` unknown
    - `order_pieces` unknown
    - `order_volume` unknown
    - `order_weight` unknown
    - `product` unknown
    - `pickup_number` unknown
    - `status` string
    - `status_updated_at` string
    - `temperature_max` unknown
    - `temperature_min` unknown
    - `trailer` unknown
    - `auto_complete_forms` boolean
    - `consignee_refno` 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
    - `custom_field11` unknown
    - `custom_field12` unknown
    - `custom_field13` unknown
    - `custom_field14` unknown
    - `custom_field15` unknown
    - `custom_field16` unknown
    - `custom_field17` unknown
    - `custom_field18` unknown
    - `custom_field19` unknown
    - `custom_field20` unknown
    - `custom_field21` unknown
    - `custom_field22` unknown
    - `custom_field23` unknown
    - `custom_field24` unknown
    - `custom_field25` unknown
    - `custom_field26` unknown
    - `custom_field27` unknown
    - `custom_field28` unknown
    - `custom_field29` unknown
    - `custom_field30` unknown
    - `custom_field31` unknown
    - `custom_field32` unknown
    - `custom_field33` unknown
    - `custom_field34` unknown
    - `custom_field35` unknown
    - `custom_field36` unknown
    - `custom_field37` unknown
    - `custom_field38` unknown
    - `custom_field39` unknown
    - `custom_field40` unknown
    - `custom_field41` unknown
    - `custom_field42` unknown
    - `custom_field43` unknown
    - `custom_field44` unknown
    - `custom_field45` unknown
    - `custom_field46` unknown
    - `custom_field47` unknown
    - `custom_field48` unknown
    - `custom_field49` unknown
    - `custom_field50` unknown
    - `custom_field51` unknown
    - `custom_field52` unknown
    - `custom_field53` unknown
    - `custom_field54` unknown
    - `custom_field55` unknown
    - `custom_field56` unknown
    - `custom_field57` unknown
    - `custom_field58` unknown
    - `custom_field59` unknown
    - `custom_field60` unknown
    - `custom_field61` unknown
    - `custom_field62` unknown
    - `custom_field63` unknown
    - `custom_field64` unknown
    - `custom_field65` unknown
    - `custom_field66` unknown
    - `custom_field67` unknown
    - `custom_field68` unknown
    - `custom_field69` unknown
    - `custom_field70` unknown
    - `custom_field71` unknown
    - `custom_field72` unknown
    - `custom_field73` unknown
    - `custom_field74` unknown
    - `custom_field75` unknown
    - `custom_field76` unknown
    - `custom_field77` unknown
    - `custom_field78` unknown
    - `custom_field79` unknown
    - `custom_field80` unknown
    - `custom_field81` unknown
    - `custom_field82` unknown
    - `custom_field83` unknown
    - `custom_field84` unknown
    - `custom_field85` unknown
    - `custom_field86` unknown
    - `custom_field87` unknown
    - `custom_field88` unknown
    - `custom_field89` unknown
    - `custom_field90` unknown
    - `custom_field91` unknown
    - `custom_field92` unknown
    - `custom_field93` unknown
    - `custom_field94` unknown
    - `custom_field95` unknown
    - `custom_field96` unknown
    - `custom_field97` unknown
    - `custom_field98` unknown
    - `custom_field99` unknown
    - `custom_field100` unknown
    - `vendor_id` string
    - `dispatch_stops` object[]
      - `dispatch_stop` object
        - `id` integer
        - `bill_of_lading` unknown
        - `comments` unknown
        - `dispatch_location_id` integer
        - `driver_load` unknown
        - `early_date` string
        - `form_ids` string[]
        - `late_date` string
        - `number` integer
        - `pallets_in` unknown
        - `pallets_out` unknown
        - `pieces` unknown
        - `status` string
        - `type` string
        - `volume` unknown
        - `weight` unknown
        - `form_entry_ids` object
        - `dispatch_trip_id` integer
        - `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
        - `custom_field11` unknown
        - `custom_field12` unknown
        - `custom_field13` unknown
        - `custom_field14` unknown
        - `custom_field15` unknown
        - `custom_field16` unknown
        - `custom_field17` unknown
        - `custom_field18` unknown
        - `custom_field19` unknown
        - `custom_field20` unknown
        - `custom_field21` unknown
        - `custom_field22` unknown
        - `custom_field23` unknown
        - `custom_field24` unknown
        - `custom_field25` unknown
        - `custom_field26` unknown
        - `custom_field27` unknown
        - `custom_field28` unknown
        - `custom_field29` unknown
        - `custom_field30` unknown
        - `custom_field31` unknown
        - `custom_field32` unknown
        - `custom_field33` unknown
        - `custom_field34` unknown
        - `custom_field35` unknown
        - `custom_field36` unknown
        - `custom_field37` unknown
        - `custom_field38` unknown
        - `custom_field39` unknown
        - `custom_field40` unknown
        - `custom_field41` unknown
        - `custom_field42` unknown
        - `custom_field43` unknown
        - `custom_field44` unknown
        - `custom_field45` unknown
        - `custom_field46` unknown
        - `custom_field47` unknown
        - `custom_field48` unknown
        - `custom_field49` unknown
        - `custom_field50` unknown
        - `custom_field51` unknown
        - `custom_field52` unknown
        - `custom_field53` unknown
        - `custom_field54` unknown
        - `custom_field55` unknown
        - `custom_field56` unknown
        - `custom_field57` unknown
        - `custom_field58` unknown
        - `custom_field59` unknown
        - `custom_field60` unknown
        - `custom_field61` unknown
        - `custom_field62` unknown
        - `custom_field63` unknown
        - `custom_field64` unknown
        - `custom_field65` unknown
        - `custom_field66` unknown
        - `custom_field67` unknown
        - `custom_field68` unknown
        - `custom_field69` unknown
        - `custom_field70` unknown
        - `custom_field71` unknown
        - `custom_field72` unknown
        - `custom_field73` unknown
        - `custom_field74` unknown
        - `custom_field75` unknown
        - `custom_field76` unknown
        - `custom_field77` unknown
        - `custom_field78` unknown
        - `custom_field79` unknown
        - `custom_field80` unknown
        - `custom_field81` unknown
        - `custom_field82` unknown
        - `custom_field83` unknown
        - `custom_field84` unknown
        - `custom_field85` unknown
        - `custom_field86` unknown
        - `custom_field87` unknown
        - `custom_field88` unknown
        - `custom_field89` unknown
        - `custom_field90` unknown
        - `custom_field91` unknown
        - `custom_field92` unknown
        - `custom_field93` unknown
        - `custom_field94` unknown
        - `custom_field95` unknown
        - `custom_field96` unknown
        - `custom_field97` unknown
        - `custom_field98` unknown
        - `custom_field99` unknown
        - `custom_field100` unknown
        - `vendor_id` string
        - `vendor_dispatch_location_id` string
    - `dispatch_trips` object[]
      - `dispatch_trip` object
        - `id` integer
        - `status` string
        - `status_updated_at` unknown
        - `loaded_miles` unknown
        - `vendor_id` string
        - `driver_id` integer
        - `vehicle_id` 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/revisions/c71780e497f5/schema)