> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Inbound Shipment

> Upsert declared quantities by productId

Upserts `quantityDeclared` by `productId` on an inbound shipment that is `created`. Products you omit stay.

**Permission:** `inbound_shipments:update`

## Path parameters

<ParamField path="id" type="string" required>
  The inbound shipment ID
</ParamField>

## Request body

<ParamField body="lines" type="array" required>
  Declared quantities to upsert by productId. At least one line is required. Each productId may appear once.

  <Expandable title="line properties">
    <ParamField body="productId" type="string" required>
      ID of the product being shipped. Look up catalog product IDs with [List
      Products](/api-reference/products/list).
    </ParamField>

    <ParamField body="quantityDeclared" type="integer" required>
      Declared quantity for this product. Must be at least 1.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "lines": [{ "productId": "jh7prod123", "quantityDeclared": 10 }]
  }
  ```
</RequestExample>

## Response

```json theme={null}
{
  "data": {
    "id": "jn7shipin123",
    "fboAccountId": "m97fbo456",
    "organizationId": "k57orgxyz",
    "status": "created",
    "shipmentNotes": "10x 1oz Gold Eagles",
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "UPS",
    "createdAt": "2025-04-05T16:00:00Z",
    "lineItems": [
      {
        "id": "jn7line456",
        "productId": "jh7prod123",
        "quantityDeclared": 10,
        "inventoryItemIds": [],
        "createdAt": "2025-04-05T16:05:00Z"
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.