Map all FNSKUs for an ASIN to a Product
POST/api/amazon/unified/fnsku-products/map-by-asin
Map every FNSKU with the given ASIN to a product. Pass product_id=null to unmap.
Remap options (all optional; omit them and the mapping is applied with the inferred intent):
intent—correction(the FNSKU was always this product; its whole history is rebuilt) orchange(fromeffective_fromonward it is this product; earlier movement stays on the previous one). Inferred when omitted:changewhen the target product was created after the FNSKU's earliest inventory event, elsecorrection.effective_from—YYYY-MM-DD, required in spirit forchange; defaults to the target product's creation date. Must not be in the future, nor earlier than the start of the period it closes.carry_cost— defaulttrue. When the target has no cost of its own, seed the FNSKU's initial unit cost from the product it is leaving so its first cost layer is not created at $0.00.reason— free text stored on the mapping period and the activity log.include_sibling_dispositions— also remap the same FNSKU's other dispositions/locations.
Returns 422 with reason_code (locked_period, effective_from_before_period, effective_from_in_future) when the change cannot be applied.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request
Responses
- 200
- 401
- 403
- 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.
Unprocessable Content
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.