Update a Shipment

put

https://api.tive.com/public/v3/Shipments/{shipmentId}

Update a shipment within the specified account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

shipmentId

string

required

shipmentId of the shipment.

Body Params

skipDeviceLocationCheck

boolean

Determines whether a shipment should start even if the tracker location does not match the shipment start location. Defaults to false.

closeActiveShipments

boolean

Close other active shipments related to the trackers being added to this shipment. When closing an existing shipment the new shipment will start at the current time. Defaults to false.

devices

array of strings | null

A list of device IDs associated with the shipment. Note, to start a shipment you must specify at least one device.

devices

trackerStartDelay

string

enum

The period of time the tracker should wait before measuring or transmitting data after the start button is pressed. This is ONLY for Solo Pro Devices.

Allowed:

shipmentId

string

required

length ≥ 1

The unique identifier of your shipment.

customFields

array of objects | null

Custom informational field that apply to your organization. Shipments allow for up to nine custom fields.

customFields

shipmentLegs

array of objects

required

For Shipments that make more than one stop, multiple Legs can be created for each stop that the shipment will make. Addresses are required for To/From for each leg, either by sending To/FromLocationId or To/FromCoordinates and To/FromAddress.

shipmentLegs*

endOfTripConfiguration

object

commodities

array of int32s | null

List of commodity ids to attach to the shipment.

commodities

mbolNumber

string | null

The Master Bill of Lading Number associated to this shipment.

mbolCarrierScac

string | null

The SCAC code of the carrier for the Master Bill of Lading Number associated to this shipment.

Headers

x-tive-account-id

int32

required

ID of the account the request will be made in.

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

200

The shipment has been updated

400

Unable to update the shipment. See response message for details.

401

Unauthorized