Get Listing Content Rules
GET/api/product-listings/:productListing/content-sync-rules
Get the content ownership rules in force for a single product listing, and where each one comes from.
A listing normally follows its sales channel's content-sync settings. This endpoint returns three things side by side: instance_defaults (what the channel says), overrides (what this listing has been customised to say), and effective (the resolved answer for every governed field).
Each entry in effective carries a source naming the level that decided it, most specific first: listing_field, listing_group, instance_field, instance_group, default. inherited is false once the listing itself decided the field, true while it still follows the channel.
risky marks a field whose change needs a human look before it is applied in bulk.
Governed fields: barcode and mpn (identity), name, brand and attributes (descriptive), images (media), weight and dimensions (physical).
Ownership values: catalog (channel edits are flagged only), channel (channel edits can be pulled into the catalog), two_way (both sides may edit; simultaneous edits become conflicts).
enabled reflects the channel — rules can be saved on a listing whose channel has content sync turned off, they simply are not acted on until it is enabled.
Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
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.