Update Shipment Line Items | ShipBob Developer API

curl -X POST https://api.shipbob.com/2026-01/shipment/1:updateLineItems \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "inventory_id": 789012,
      "quantity": 2,
      "fulfillment_center_id": 8,
      "id": 123456,
      "is_manually_assigned_lot": false,
      "lot_date": "2024-06-01",
      "lot_number": "LOT-2024-001"
    }
  ]
}'

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "string"
  },
  "id": 123456,
  "is_success": true,
  "shipment_line_items": [
    {
      "action": "string",
      "inventory_id": 789012,
      "new_value": "string",
      "previous_value": "string"
    }
  ]
}

Updates the line items for a specific shipment. The request body must include the complete list of line items as returned by the GET /{shipmentId}:getLineItems endpoint — partial updates are not supported. Retrieve the current line items first, modify the desired fields, and submit the full payload.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token or OAuth2

Path parameters

shipmentIdintegerRequired

Unique identifier of the shipment

Request

This endpoint expects an object.

itemslist of objectsRequired

Complete list of line items for the shipment. Must include all line items — partial updates are not supported

Response

errorobject

Error details if the update was not successful

idlong

Unique identifier of the shipment

is_successboolean

Indicates whether the update was successful

shipment_line_itemslist of objects or null

List of line item changes applied to the shipment

Errors

400

Bad Request Error