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

# Edit Product Dimensions & Weight

> Update a product's physical dimensions and weight (length/width/height/depth, gross/net weight) — the programmatic equivalent of the dashboard's dimensions & weight page.

Programmatic equivalent of the dashboard's `products/<gtin>/dimensions/` page.

## When to use

* A brand owner needs to enter or correct GDSN/GS1 physical-measurement
  fields for a claimed product: length, width, height, depth, gross weight,
  or net weight.

## Auth

`X-API-Key` header or OAuth token with `products:write` scope. The caller
must be an `OWNER`, `MANAGER`, or `EDITOR` on the organization that owns the
GTIN.

## Flow

```
PATCH /products/api/v1/products/{gtin}
```

Every field is optional; omit or send `null` to leave unchanged. Each numeric
value pairs with its own UN/CEFACT unit-of-measure code.

| Field          | Unit field         | Notes                                                 |
| -------------- | ------------------ | ----------------------------------------------------- |
| `length`       | `length_uom`       | e.g. `CMT`, `MMT`, `MTR`, `INH`                       |
| `width`        | `width_uom`        | same unit set                                         |
| `height`       | `height_uom`       | same unit set                                         |
| `depth`        | `depth_uom`        | same unit set                                         |
| `gross_weight` | `gross_weight_uom` | including packaging — e.g. `GRM`, `KGM`, `LBR`, `ONZ` |
| `net_weight`   | `net_weight_uom`   | excluding packaging — same unit set                   |

All numeric values must be `>= 0` (a negative dimension returns `422`).

Returns `200` with the updated `ProductOut`, `403` for a caller without the
required role, `404` if the GTIN isn't owned by the caller's organization.

## Related skills

This is the same `PATCH` endpoint as `edit-product-basic-info` and
`edit-product-classification` — the dashboard splits it across three pages,
but a single request can set fields from all three at once.