Skip to main content

Update Size Profile

PUT 

/api/merchandising/size-profiles/:sizeProfile

Update a size profile. The entries sent replace the whole size run.

Required scope: inventory:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body:

  • name (required, string, max 255)
  • scope_type (required): global, category, brand or product — what the size run applies to
  • scope_id (optional, integer ≥ 1): the category, brand or product id; omit for global
  • derived_from_window_days (optional, integer ≥ 1): the sales-history window the shares came from, if any
  • entries (required, array, at least 1): the size run
    • entries.*.size_label (required, string, max 255), e.g. "3T"
    • entries.*.share_pct (required, number 0–100): the size's share of the style's units
    • entries.*.sort_order (optional, integer ≥ 0): display order

The shares must total 100% (±0.5).

Requires a Bearer token with the inventory read/write scope.

Request​

Responses​

OK

Response Headers
    Content-Type