update_listing_content
Seller Central only (a Vendor Central account is refused by name: its content is changed in Vendor Central). Change listing CONTENT on Amazon (title, bullets, description, backend keywords, dimensions, any editable product-type attribute — never the offer: price, stock, shipping, tax, condition or offer images, which Nova refuses as not-editable) for up to 50 SKUs of ONE account on ONE marketplace. Each row is { sku, attributes: { column: value } } with the columns get_listing_content returns: a string for a text attribute, an array of strings for bullet_point, a number for a numeric leaf, null to DELETE an attribute; a column you omit is untouched. TWO-STEP, never skip the preview: call WITHOUT commit; the server diffs against Amazon's current values, validates locally against the product type schema and on Amazon (VALIDATION_PREVIEW — nothing is written), and returns the before → after table, the issues and a confirmationToken; show them to the user and only after explicit approval call again with the SAME account/marketplace/rows plus commit:true and the token. ACCEPTED means Amazon took the change for processing; STORED (about two minutes later) means Amazon holds it; PUBLISHED means the public product page shows it, verified on the public catalogue within minutes to hours and re-checked for 72 hours. get_listing_change_status gives each status with its clocks and the next check. For more than 50 SKUs, point the user to the bulk template in Nova. Requires the OAuth connection, the OWNER role, and the Amazon write flag on the workspace.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account": "<account>",
"marketplace": "<marketplace>",
"rows": "<rows>"
},
"name": "update_listing_content"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| commit | No | Omit/false = preview (diff + validation on Amazon, no write). true = write; requires the confirmationToken from the preview. | |
| reason | No | One sentence, ALWAYS IN ENGLISH (regardless of the conversation language), on WHY you are making this call — the user question or your analytical goal. Recorded so the seller can see how their data is used. | |
| account | Yes | The seller account (seller_partner_id, or an unambiguous account name). One account per call. | |
| marketplace | Yes | A country code (FR), a domain (amazon.fr) or the Amazon marketplace id. One marketplace per call: an Amazon submission is per SKU × marketplace. | |
| expectedBefore | No | Returned by the preview (sku → attribute → hash of the value shown as before). Resend it on commit: the write is refused if Amazon's value moved since the preview. | |
| confirmationToken | No | The token the preview returned — proves the user saw exactly this payload. |