---
title: "Set Shipment Devices"
method: PUT
path: "/public/v3/Shipments/{shipmentId}/devices"
tags: ["Shipments"]
---

# Set Shipment Devices

`PUT /public/v3/Shipments/{shipmentId}/devices`

Set the list of devices for a shipment.

## Path parameters

- `shipmentId` string, required

## Headers

- `x-tive-account-id` integer, required

## Request body

- ShipmentDevicesSetRequest
  - `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` string[], nullable — A list of device IDs associated with the shipment. Note, to <emp>start</emp> a shipment you must specify at least one device.

## Response `200`

Shipment devices updated.

## Other responses

- `400` — Unable to update shipment devices. See response message for details.
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/revisions/9a8d869e3cdc/schema)