Update Size Profile
PUT/api/merchandising/size-profiles/:sizeProfile
Update a size profile. The entries sent replace the whole size run.
inventory:writeGrant 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
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.