Skip to main content
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

Every field is optional; omit or send null to leave unchanged. Each numeric value pairs with its own UN/CEFACT unit-of-measure code. 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. 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.