aplusContent_updateContentDocument

Replace the content of an existing A+ document, keeping its key and ASIN links — to revise copy, module order or images without creating a new document.

destructiveAmazon Seller (SP-API)sp.aplusContent_2020-11-01

ASIN links change through aplusContent_postContentDocumentAsinRelations. Amazon SP-API · updateContentDocument · POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey} Gate: approve — interactive: show the change (Amazon's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask.

Call it

In an AI client (MCP)

tools/call

{
  "name": "aplusContent_updateContentDocument",
  "arguments": {
    "store": "myStore-US",
    "contentReferenceKey": "<contentReferenceKey>",
    "contentDocument": {}
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/aplusContent_updateContentDocument \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","contentReferenceKey":"<contentReferenceKey>","contentDocument":{}}'

Early access — the Tool API is open on request, contact us.

Arguments

Name	Type	Description
`store`required	`string`	the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
`contentReferenceKey`required	`string`	the A+ content document key (from aplusContent_searchContentDocuments).
`contentDocument`required	`object`	The full new document body — same shape as create. Required: name (maxLength 100), contentType (Allowed: EBC = Seller Central A+, use this for seller accounts \| EMC = Vendor Central A+), locale (IETF tag, HYPHENATED — pattern ^[a-z]{2,}-[A-Z0-9]{2,}$, e.g. 'en-US'), contentModuleList (1–100 modules). Optional: contentSubType. See aplusContent_create_and_publish for the module shape and text limits (contentModuleType values: the Body block).

Result

Every tool answers {notification, data, human_action}; data carries:

data.contentReferenceKey — same as input.
data.warnings — (only when present) Amazon's warnings — the notification is then a warning.

Body (Amazon schema)

contentDocument*: {name* (max 100 chars), contentType*: EBC | EMC, contentSubType, locale* (min 5 chars),
  contentModuleList*: [{contentModuleType*, standardCompanyLogo, standardComparisonTable,
    standardFourImageText, standardFourImageTextQuadrant, standardHeaderImageText, standardImageSidebar,
    standardImageTextOverlay, standardMultipleImageText, standardProductDescription,
    standardSingleImageHighlights, standardSingleImageSpecsDetail, standardSingleSideImage,
    standardTechSpecs, standardText, standardThreeImageText}] (1–100)}
  contentDocument.contentModuleList.contentModuleType: STANDARD_COMPANY_LOGO | STANDARD_COMPARISON_TABLE |
    STANDARD_FOUR_IMAGE_TEXT | STANDARD_FOUR_IMAGE_TEXT_QUADRANT | STANDARD_HEADER_IMAGE_TEXT |
    STANDARD_IMAGE_SIDEBAR | STANDARD_IMAGE_TEXT_OVERLAY | STANDARD_MULTIPLE_IMAGE_TEXT |
    STANDARD_PRODUCT_DESCRIPTION | STANDARD_SINGLE_IMAGE_HIGHLIGHTS | STANDARD_SINGLE_IMAGE_SPECS_DETAIL |
    STANDARD_SINGLE_SIDE_IMAGE | STANDARD_TECH_SPECS | STANDARD_TEXT | STANDARD_THREE_IMAGE_TEXT
  contentDocument.contentModuleList.standardImageTextOverlay.overlayColorType: DARK | LIGHT
  contentDocument.contentModuleList.standardSingleSideImage.imagePositionType: LEFT | RIGHT

Gotchas

SUBMITTED or APPROVED content: suspend it first (aplusContent_postContentDocumentSuspendSubmission), update, then resubmit.

Workflow

1. aplusContent_getContentDocument for the current contentDocument. 2. Change it (e.g. a STANDARD_HEADER_IMAGE_TEXT module's headline) and call this tool with the whole document. 3. aplusContent_postContentDocumentApprovalSubmission to publish the new version.

aplusContent_updateContentDocument

Call itCopy Anchor Link

ArgumentsCopy Anchor Link

ResultCopy Anchor Link

Body (Amazon schema)Copy Anchor Link

GotchasCopy Anchor Link