---
title: "updateContentDocument"
method: POST
path: "/aplus/2020-11-01/contentDocuments/{contentReferenceKey}"
tags: ["A+ Content Management v2020-11-01"]
---

# updateContentDocument

`POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey}`

Updates an existing A+ Content document.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 10 | 10 |

The `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `contentReferenceKey` string, required

## Query parameters

- `marketplaceId` string, required

## Request body

- PostContentDocumentRequest
  - `contentDocument` ContentDocument, required — The A+ Content document. This is the enhanced content that is published to product detail pages.
    - `name` string, required — The A+ Content document name.
    - `contentType` 'EBC' | 'EMC', required — The A+ Content document type.
    - `contentSubType` string — The A+ Content document subtype. This represents a special-purpose type of an A+ Content document. Not every A+ Content document type has a subtype, and subtypes can change at any time.
    - `locale` string, required — The IETF language tag, which supports the primary language subtag and one secondary language subtag. The secondary language subtag is usually a regional designation. This doesn't support subtags other than the primary and secondary subtags. **Pattern:** ^[a-z]{2,}-[A-Z0-9]{2,}$
    - `contentModuleList` ContentModule[], required — A list of A+ Content modules.
      - `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', required — The type of A+ Content module.
      - `standardCompanyLogo` StandardCompanyLogoModule — The standard company logo image.
        - `companyLogo` ImageComponent, required — A reference to an image, hosted in the A+ Content media library.
          - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
          - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
            - `size` ImageDimensions, required — The dimensions that extend from the top left corner of the image (this applies to cropped and uncropped images). `ImageDimensions` units must be in pixels.
              - …
            - `offset` ImageOffsets — The top left corner of the cropped image, specified in the original image's coordinate space.
              - …
          - `altText` string, required — The alternative text for the image.
      - `standardComparisonTable` StandardComparisonTableModule — The standard product comparison table.
        - `productColumns` StandardComparisonProductBlock[]
          - `position` integer, required — The rank or index of this comparison product block within the module. Different blocks cannot occupy the same position within a single module.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `title` string — The comparison product title.
          - `asin` string — The ASIN of the item.
          - `highlight` boolean — When true, indicates that this content block is visually highlighted.
          - `metrics` PlainTextItem[] — Comparison metrics for the product.
            - `position` integer, required — The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
            - `value` string, required — The actual plain text.
        - `metricRowLabels` PlainTextItem[]
          - `position` integer, required — The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
          - `value` string, required — The actual plain text.
      - `standardFourImageText` StandardFourImageTextModule — Four standard images with text, presented across a single row.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `block1` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block2` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block3` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block4` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardFourImageTextQuadrant` StandardFourImageTextQuadrantModule — Four standard images with text, presented on a grid of four quadrants.
        - `block1` StandardImageTextBlock, required — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block2` StandardImageTextBlock, required — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block3` StandardImageTextBlock, required — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block4` StandardImageTextBlock, required — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardHeaderImageText` StandardHeaderImageTextModule — Standard headline text, an image, and body text.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardImageSidebar` StandardImageSidebarModule — Two images, two paragraphs, and two bulleted lists. One image is smaller and displayed in the sidebar.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `imageCaptionBlock` StandardImageCaptionBlock — The A+ Content standard image and caption block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `caption` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
        - `descriptionTextBlock` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `descriptionListBlock` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
          - `textList` TextItem[], required
            - `position` integer, required — The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
            - `text` TextComponent, required — Rich text content.
              - …
        - `sidebarImageTextBlock` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `sidebarListBlock` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
          - `textList` TextItem[], required
            - `position` integer, required — The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
            - `text` TextComponent, required — Rich text content.
              - …
      - `standardImageTextOverlay` StandardImageTextOverlayModule — A standard background image with a floating text box.
        - `overlayColorType` 'DARK' | 'LIGHT', required — The relative color scheme of your content.
        - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardMultipleImageText` StandardMultipleImageTextModule — Standard images with text, presented one at a time. The user clicks on thumbnails to view each block.
        - `blocks` StandardImageTextCaptionBlock[]
          - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
            - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
              - …
            - `headline` TextComponent — Rich text content.
              - …
            - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
              - …
          - `caption` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
      - `standardProductDescription` StandardProductDescriptionModule — Standard product description text.
        - `body` ParagraphComponent, required — A list of rich text content that is typically presented in a text box.
          - `textList` TextComponent[], required
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
      - `standardSingleImageHighlights` StandardSingleImageHighlightsModule — A standard image with several paragraphs and a bulleted list.
        - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
          - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
          - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
            - `size` ImageDimensions, required — The dimensions that extend from the top left corner of the image (this applies to cropped and uncropped images). `ImageDimensions` units must be in pixels.
              - …
            - `offset` ImageOffsets — The top left corner of the cropped image, specified in the original image's coordinate space.
              - …
          - `altText` string, required — The alternative text for the image.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `textBlock1` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `textBlock2` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `textBlock3` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `bulletedListBlock` StandardHeaderTextListBlock — The A+ standard fixed-length list of text and a related headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `block` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
            - `textList` TextItem[], required
              - …
      - `standardSingleImageSpecsDetail` StandardSingleImageSpecsDetailModule — A standard image with paragraphs, a bulleted list, and extra space for technical details.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
          - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
          - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
            - `size` ImageDimensions, required — The dimensions that extend from the top left corner of the image (this applies to cropped and uncropped images). `ImageDimensions` units must be in pixels.
              - …
            - `offset` ImageOffsets — The top left corner of the cropped image, specified in the original image's coordinate space.
              - …
          - `altText` string, required — The alternative text for the image.
        - `descriptionHeadline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `descriptionBlock1` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `descriptionBlock2` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `specificationHeadline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `specificationListBlock` StandardHeaderTextListBlock — The A+ standard fixed-length list of text and a related headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `block` StandardTextListBlock — The A+ Content standard fixed-length list of text, usually presented as bullet points.
            - `textList` TextItem[], required
              - …
        - `specificationTextBlock` StandardTextBlock — The A+ Content standard text box block, which contains a paragraph and a headline.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardSingleSideImage` StandardSingleSideImageModule — A standard headline and body text with an image on the side.
        - `imagePositionType` 'LEFT' | 'RIGHT', required — The content's relative positioning.
        - `block` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
      - `standardTechSpecs` StandardTechSpecsModule — The standard table of technical feature names and definitions.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `specificationList` StandardTextPairBlock[], required — The specification list.
          - `label` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `description` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
        - `tableCount` integer — The number of tables you want present. Features are evenly divided between the tables.
      - `standardText` StandardTextModule — A standard headline and body text.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `body` ParagraphComponent, required — A list of rich text content that is typically presented in a text box.
          - `textList` TextComponent[], required
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
      - `standardThreeImageText` StandardThreeImageTextModule — Three standard images with text, presented across a single row.
        - `headline` TextComponent — Rich text content.
          - `value` string, required — The actual plain text.
          - `decoratorSet` Decorator[] — A set of content decorators.
            - `type` 'LIST_ITEM' | 'LIST_ORDERED' | 'LIST_UNORDERED' | 'STYLE_BOLD' | 'STYLE_ITALIC' | 'STYLE_LINEBREAK' | 'STYLE_PARAGRAPH' | 'STYLE_UNDERLINE' — The type of rich text decorator.
            - `offset` integer — The starting value of this decorator within the content string. Use zero (`0`) for the first value.
            - `length` integer — The number of content characters to alter with this decorator. Decorators, such as line breaks, can have zero length and fit between characters.
            - `depth` integer — The relative intensity or variation of this decorator. Decorators, such as bullet-points, can have multiple indentation depths.
        - `block1` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block2` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …
        - `block3` StandardImageTextBlock — The A+ Content standard image and text box block.
          - `image` ImageComponent — A reference to an image, hosted in the A+ Content media library.
            - `uploadDestinationId` string, required — This identifier is provided by the [Uploads API](https://developer-docs.amazon.com/sp-api/reference/welcome-to-api-references).
            - `imageCropSpecification` ImageCropSpecification, required — The instructions for optionally cropping an image. If you don't want to crop the image, set the dimensions to the original image size. If the image is cropped and you don't include offset values, the coordinates of the top left corner of the cropped image are set to (0,0) by default.
              - …
            - `altText` string, required — The alternative text for the image.
          - `headline` TextComponent — Rich text content.
            - `value` string, required — The actual plain text.
            - `decoratorSet` Decorator[] — A set of content decorators.
              - …
          - `body` ParagraphComponent — A list of rich text content that is typically presented in a text box.
            - `textList` TextComponent[], required
              - …

## Response `200`

Success.

- PostContentDocumentResponse — The base response data for all A+ Content operations when a request is successful or partially successful. Individual operations can extend this with additional data.
  - `warnings` Error[] — A set of messages to the user, such as warnings or comments.
    - `code` string, required — An error code that identifies the type of error that occurred.
    - `message` string, required — A message that describes the error condition.
    - `details` string — Additional details that can help the caller understand or fix the issue.
  - `contentReferenceKey` string, required — A unique reference key for the A+ Content document. A content reference key cannot form a permalink and might change in the future. A content reference key is not guaranteed to match any A+ content identifier.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `401` — The request's Authorization header is not formatted correctly or does not contain a valid token.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The specified resource does not exist.
- `410` — The specified resource no longer exists.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)
