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

# Update Shipping Dimension

> Update an existing shipping dimension preset

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Update an existing shipping dimension preset. All fields are optional -- only the provided fields are updated.

### Use Cases

* Correct packaging dimensions for a preset
* Rename a dimension preset
* Change the unit of measurement

## Path Parameters

<ParamField path="shippingDimensionsId" type="string" required>
  The ID of the shipping dimension preset to update.
</ParamField>

## Request Body

<ParamField body="type" type="string">
  Dimension type. Must be `generic` or `productSpecific`.
</ParamField>

<ParamField body="productId" type="string">
  Shopify product ID.
</ParamField>

<ParamField body="title" type="string">
  A human-readable name for the preset.
</ParamField>

<ParamField body="dimensionUnit" type="string">
  Unit of measurement. Must be one of: `in`, `cm`, `mm`, `ft`, `m`, `yd`.
</ParamField>

<ParamField body="heightValue" type="number">
  Package height. Minimum 0.
</ParamField>

<ParamField body="widthValue" type="number">
  Package width. Minimum 0.
</ParamField>

<ParamField body="lengthValue" type="number">
  Package length. Minimum 0.
</ParamField>

## Response

```json 200 theme={null}
{
  "success": true,
  "data": {
    "_id": "665a1b2e3d98f0001a2b3c52",
    "type": "generic",
    "title": "Medium Box (Updated)",
    "dimensionUnit": "in",
    "heightValue": 9,
    "widthValue": 10,
    "lengthValue": 12
  }
}
```

## Example

```bash theme={null}
curl -X PUT "https://staging-api.puppetvendors.com/shipping/dimensions/665a1b2e3d98f0001a2b3c52" \
  -H "x-access-token: YOUR_VENDOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Medium Box (Updated)",
    "heightValue": 9
  }'
```