{"platforms":[{"id":"SELLING_PARTNER","label":"Seller Central & Vendor Central","description":null},{"id":"AMAZON_ADS","label":"Amazon Ads","description":"Amazon Ads Action models and flows follow the structure shown in the [Amazon Ads API documentation](https://advertising.amazon.com/API/docs/en-us/guides/campaign-management/entities/overview#entity-relationships)."}],"groups":[{"id":"listings","label":"Listings","platform":"SELLING_PARTNER","description":null,"guides":[{"id":"listing-validation-preview","title":"Listing validation preview","markdown":"`AMAZON_LISTINGS_CREATE_VERIFY`, `AMAZON_LISTINGS_UPDATE_VERIFY`, `AMAZON_LISTINGS_DETAILS_UPDATE_VERIFY`, and `AMAZON_LISTINGS_PRICING_UPDATE_VERIFY` call Amazon Listings Items with `mode=VALIDATION_PREVIEW`. Each call checks one SKU and returns Amazon status, submission ID, and issues. The preview does not create or change the listing. Amazon validation preview does not accept a merge. DataDoe previews a merge with replace and the same values. The write still sends merge.\n\nVERIFY Actions accept up to five distinct SKUs through the API or MCP. All changes for each SKU are sent together in one Amazon request. Update previews also keep the matching write Action’s total change limit: 5,000 through the API or 50 through MCP.\n\n`dryRun` is a different check. It validates the DataDoe request and does not submit the change. For create and details updates, `dryRun` also checks the product-type schema. A pricing dry run checks that schema when the change includes `productType`. A basic listing update dry run does not fetch it. A delete dry run checks the SKU list and does not call Amazon.\n\nTo check a listing before a write, run `dryRun`, then the matching VERIFY Action, then the write Action. Pricing preview is Seller Central only, matching `AMAZON_LISTINGS_PRICING_UPDATE`."},{"id":"delete-a-listing","title":"Delete a listing","markdown":"`AMAZON_LISTINGS_DELETE` deletes listings by SKU for Seller Central and Vendor Central. Send `skus`. DataDoe submits a JSON listings feed. Each message uses `operationType` DELETE and does not include a product type or attributes.\n\n`dryRun` checks the SKU list and does not call Amazon. Amazon's delete operation has no validation preview, so there is no verify Action.\n\nDeleting a parent SKU removes that parent listing and its relationships to child listings. The child listings remain. Amazon does not change whether buyers can purchase them.\n\nVendor Central requests require `vendorCode`. Seller Central requests must not include `vendorCode`. DataDoe rejects duplicate SKUs in one request."},{"id":"listing-requirements","title":"Listing requirements","markdown":"Each change in `AMAZON_LISTINGS_CREATE` can include `requirements`. When you omit it, DataDoe uses `LISTING`.\n\nChoose one value:\n\n- `LISTING` creates a full listing, with product data and your offer\n- `LISTING_OFFER_ONLY` adds your offer on an ASIN that already exists in the Amazon catalog\n- `LISTING_PRODUCT_ONLY` sends product data without an offer\n\nA dry run checks attributes against the product type schema for that value. Load the same value with `AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND` and `productTypeRequirementsSet`.\n\nFor `LISTING_OFFER_ONLY`, send the SKU, condition, price, and fulfillment attributes required by that schema."},{"id":"listing-images","title":"Listing images","markdown":"To set listing images on create or update, upload files to the `LISTING_IMAGES` group first, then reference file UUIDs in `AMAZON_LISTINGS_CREATE` or `AMAZON_LISTINGS_UPDATE`. See [Files](/hub/docs/datadoe-features/files) for upload details and [Actions - Manage Images](/hub/docs/datadoe-features/actions-manage-images) for the full workflow, slot mapping, and MCP and API examples."}]},{"id":"aplus-content","label":"A+ Content","platform":"SELLING_PARTNER","description":null,"guides":[{"id":"a-content-images","title":"A+ Content images","markdown":"To include images in A+ Content documents, upload files to the `APLUS_IMAGES` group first, then reference file UUIDs in image components inside `AMAZON_APLUS_CONTENT_ADD`, `AMAZON_APLUS_CONTENT_UPDATE`, or `AMAZON_APLUS_CONTENT_VALIDATE`."},{"id":"premium-a-and-brand-story","title":"Premium A+ and Brand Story","markdown":"A+ Content Actions accept Standard (`STANDARD_*`), Premium (`PREMIUM_*`), and Brand Story (`BRAND_STORY_*`) modules. Keep one module family per document:\n\n- Standard and Premium documents use `contentType` `EBC` (sellers) or `EMC` (vendors) and take up to seven modules. Standard documents of vendors take up to five.\n- Brand Story documents use `contentType` `BrandStory`: exactly one `BRAND_STORY_IMAGE_WITH_LOGO` background module plus up to 19 cards, for sellers and vendors.\n\nPremium video modules (`PREMIUM_VIDEO_TEXT`, `PREMIUM_HERO_VIDEO`, `PREMIUM_VIDEO_IMAGE_CAROUSEL`) reference a video and its thumbnail by `videoMediaId` and `imageMediaId`. Register the pairing with `AMAZON_APLUS_MEDIA_ADD`: pass the existing video `mediaId`, its `descriptions` (one per locale), and a thumbnail image as an `APLUS_IMAGES` file, an existing media library path, or a `mediaId`. DataDoe does not upload video files. Amazon can take up to 48 hours to process a video; check its status with `AMAZON_APLUS_MEDIA_FIND`.\n\nYou can send `AMAZON_APLUS_CONTENT_FIND` output back to `AMAZON_APLUS_CONTENT_UPDATE` after your changes. Every image needs `imageCropSpecification`, except catalog images (`/images/I/…`) that Amazon fills in for ASIN cards.\n\n`AMAZON_APLUS_CONTENT_FIND` skips documents with premium modules that Amazon SP-API does not expose. Those documents are listed under `skipped` and do not fail the Action."}]},{"id":"orders","label":"Orders","platform":"SELLING_PARTNER","description":"`AMAZON_ORDERS_FIND` and `AMAZON_ORDERS_GET_METRICS` are a live preview of current Amazon data. For large volumes and long-term analysis, use an Export or a BigQuery query. Those also refresh during the day. Repeated FIND Actions cost more than one Export or one query.","guides":[]},{"id":"buyer-messaging","label":"Buyer messaging","platform":"SELLING_PARTNER","description":null,"guides":[]},{"id":"fbm-shipping","label":"FBM shipping and tracking","platform":"SELLING_PARTNER","description":null,"guides":[]},{"id":"fba-mcf","label":"FBA and MCF","platform":"SELLING_PARTNER","description":"MCF order lifecycle uses Fulfillment Outbound **v2026-07-04**. Return actions use **v2020-07-01** because Amazon has not ported returns to v2026.","guides":[{"id":"india-payment-on-delivery","title":"India payment on delivery","markdown":"Payment on delivery is available only for a connected India Seller account shipping to an address in India. Prepaid Multi-Channel Fulfillment (MCF) orders stay the default. Omit `paymentOnDelivery`, or set it to `false`, and do not send a line-item service price.\n\nPreview the option with `AMAZON_MCF_ORDERS_PREVIEW` before you create an order. Set `includePaymentOnDelivery` to `true`. Amazon reports `delivery.paymentOnDelivery` as `ENABLED` or `DISABLED` on each offer, and includes any constraints. The preview does not create an order, collect payment, or complete delivery. DataDoe rejects a destination outside India. It also rejects a Seller connection that is not the India marketplace.\n\nCreate the order with `AMAZON_MCF_ORDERS_ADD`. Set `paymentOnDelivery` to `true` and send a price in Indian rupees (INR) on every line item, in `perUnitServicePrice`. Each line keeps its own amount. The amount must be greater than zero. DataDoe rejects a missing price and a price sent without `paymentOnDelivery` set to `true`. It also rejects a currency other than INR and a destination whose `countryCode` is not `IN`. It does not fill in a missing price or currency. A Seller connection that is not the India marketplace is rejected as well.\n\nAmazon accepting the order means Amazon accepted the fulfillment request. Acceptance does not mean the customer paid, or that delivery is complete.\n\n`AMAZON_MCF_FEATURES_MARKETPLACE_FIND` returns these same rules and does not call Amazon. REST `POST /api/v1/actions` and MCP `actions_start` use the same fields.\n\nFor example, preview payment on delivery:\n\n```json\n{\n    \"type\": \"AMAZON_MCF_ORDERS_PREVIEW\",\n    \"sellerOrVendorId\": \"your-seller-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"includePaymentOnDelivery\": true,\n        \"destination\": {\n            \"deliveryAddress\": {\n                \"name\": \"Mary Major\",\n                \"addressLine1\": \"Connaught Place\",\n                \"city\": \"New Delhi\",\n                \"postalCode\": \"110001\",\n                \"countryCode\": \"IN\"\n            }\n        },\n        \"lineItems\": [\n            {\n                \"product\": { \"productIdentifier\": { \"amazonSku\": \"SKU-1\" } },\n                \"amount\": { \"unit\": \"EACHES\", \"value\": \"1\" }\n            }\n        ]\n    }\n}\n```\n\nCreate the order with `AMAZON_MCF_ORDERS_ADD` and these details. Send a separate INR price for each line:\n\n```json\n{\n    \"orders\": [\n        {\n            \"orderId\": \"india-order-1\",\n            \"paymentOnDelivery\": true,\n            \"fulfillmentConfiguration\": {\n                \"serviceLevel\": { \"serviceTiers\": [\"STANDARD\"] }\n            },\n            \"destination\": {\n                \"deliveryAddress\": {\n                    \"name\": \"Mary Major\",\n                    \"addressLine1\": \"Connaught Place\",\n                    \"city\": \"New Delhi\",\n                    \"postalCode\": \"110001\",\n                    \"countryCode\": \"IN\"\n                }\n            },\n            \"lineItems\": [\n                {\n                    \"lineItemId\": \"item-1\",\n                    \"product\": { \"productIdentifier\": { \"amazonSku\": \"SKU-1\" } },\n                    \"amount\": { \"unit\": \"EACHES\", \"value\": \"1\" },\n                    \"fulfillmentConfiguration\": {\n                        \"services\": {\n                            \"delivery\": {\n                                \"paymentOnDelivery\": {\n                                    \"perUnitServicePrice\": {\n                                        \"currencyCode\": \"INR\",\n                                        \"amount\": \"14.99\"\n                                    }\n                                }\n                            }\n                        }\n                    }\n                },\n                {\n                    \"lineItemId\": \"item-2\",\n                    \"product\": { \"productIdentifier\": { \"amazonSku\": \"SKU-2\" } },\n                    \"amount\": { \"unit\": \"EACHES\", \"value\": \"2\" },\n                    \"fulfillmentConfiguration\": {\n                        \"services\": {\n                            \"delivery\": {\n                                \"paymentOnDelivery\": {\n                                    \"perUnitServicePrice\": {\n                                        \"currencyCode\": \"INR\",\n                                        \"amount\": \"20.00\"\n                                    }\n                                }\n                            }\n                        }\n                    }\n                }\n            ]\n        }\n    ]\n}\n```"}]},{"id":"vendor-purchase-orders","label":"Vendor purchase orders","platform":"SELLING_PARTNER","description":"Vendor accounts only. Purchase order lists, purchase order status, and shipment details stay in the warehouse tables. These Actions submit and retrieve live Retail Procurement and Direct Fulfillment operations, including invoice submission.","guides":[]},{"id":"vendor-direct-fulfillment","label":"Vendor Direct Fulfillment","platform":"SELLING_PARTNER","description":"Vendor accounts only. Direct Fulfillment container labels are not an Action. Creating or retrieving Direct Fulfillment shipping labels, retrieving packing slips, and retrieving an India customer invoice return customer information. Those Actions require PII access, the same entitlement as Vendor Direct Fulfillment Orders PII.","guides":[]},{"id":"finances","label":"Balances and payouts","platform":"SELLING_PARTNER","description":"Sellers only. These Actions read Seller Central balances and payouts. They do not change the Amazon account. A read Action can run when the account access level is **Read only**.\n\nAmazon allows 0.5 requests per second, so each extra query adds about two seconds. Each query returns one page. Pass `nextToken` with the same other fields to get the next page. Omit store ids to include every store Amazon returns for the connection region.\n\nA balance amount uses `currencyCode` and `currencyAmount`. A payout amount uses `unit` and `value`, and can be null when the payout status is `NO_PAYOUT`. A current balance includes `lastUpdatedTime`. A past balance includes `asOfDate`, such as `2026-10-01` for 1 October 2026. Payout history needs `createdAfter` unless you set `payoutId`.","guides":[]},{"id":"ads-campaign-management","label":"Campaign management","platform":"AMAZON_ADS","description":null,"guides":[{"id":"find-with-many-ids","title":"Find with many IDs","markdown":"Amazon accepts up to 100 IDs in one ID filter (`campaignIdFilter`, `adGroupIdFilter`, `adIdFilter`, `targetIdFilter`, `portfolioIdFilter`, `adAssociationIdFilter`). In `AMAZON_ADS_CAMPAIGNS_FIND`, `AMAZON_ADS_AD_GROUPS_FIND`, `AMAZON_ADS_TARGETS_FIND`, `AMAZON_ADS_ADS_FIND`, and `AMAZON_ADS_AD_ASSOCIATIONS_FIND`, one ID filter can have more IDs. DataDoe queries the IDs in groups of 100 and returns up to `maxResults` results (100 by default). If there are more results, the response has a `nextToken`. Send it with the same query to get the next page. Only one ID filter per request can have more than 100 IDs. Split other large ID filters into several Actions. These FIND Actions count as 1 item per call, so a longer ID list in that one filter does not add AI Tokens. Reads that count each identifier, such as listing lookups, cost less when the identifiers are in one Action."},{"id":"sponsored-brands-campaigns","title":"Sponsored Brands campaigns","markdown":"`AMAZON_ADS_CAMPAIGNS_ADD` for `SPONSORED_BRANDS` uses the brand entity ID (`ENTITY…`) as `brandId`: `AMAZON_ADS_BRANDS_FIND.brandEntityId`, the same value as `AMAZON_ADS_CAMPAIGNS_FIND.brandId`. Do not send the `A…` `brandId` from brands FIND. `brandId` is required for sellers and optional for Vendor Central accounts. Use `kpi: \"CLICKS\"`, `bidStrategy: \"MANUAL\"` (or omit it), and exactly one `DAILY` or `LIFETIME` budget. Placement adjustments support `HOME_PAGE`, `PRODUCT_PAGE`, and `REST_OF_SEARCH` only.\n\nManual vs theme targeting is locked when the campaign is created. On `AMAZON_ADS_CAMPAIGNS_ADD`, omit `smartDefault` or set it to `\"MANUAL\"`. DataDoe sends manual targeting, so the campaign can take product and keyword targets. Set `smartDefault` to `\"TARGETING\"` to use theme targets. Theme targeting blocks product targets. Send one value, not a list.\n\nDo not set `smartDefault` on `AMAZON_ADS_CAMPAIGNS_UPDATE`. Campaigns that already exist keep their targeting. To change manual vs theme targeting, create a new campaign."},{"id":"sponsored-brands-ads","title":"Sponsored Brands ads","markdown":"`AMAZON_ADS_ADS_ADD` for `SPONSORED_BRANDS` (`adType: \"COMPONENT\"`) supports two formats: product collection (`creative.componentCreative.productCollectionSettings`) and video (`creative.componentCreative.productVideoSettings`). Other Sponsored Brands formats are not supported. Every ad needs `adGroupId`, `name`, and `state`.\n\n- Product collection: created as an Amazon Manual Collection ad. `brand` (at most 30 characters), at most one `brandLogos` entry, at most one headline of at most 32 characters (sent as the ad title; Amazon generates one when omitted), and 3–10 product ASINs. `landingPage` can be `STORE` (with a Store `landingPageUrl`) or `ASIN_LIST` (a Store URL is used as the Store page; otherwise the page lists the product ASINs, and `landingPageAsins`, if sent, must match them). `customImages`, `CUSTOM_URL` landing pages, and `creativePropertiesToOptimize` are not supported.\n- Video: exactly one `videos` entry and one product ASIN. The ad lands on the product detail page.\n\n`AMAZON_ADS_ADS_UPDATE` for Sponsored Brands ads changes only `name` and `state`; creative changes are not supported. Targets can be added to a Sponsored Brands ad group only after it has at least one ad."},{"id":"sponsored-display-ad-groups","title":"Sponsored Display ad groups","markdown":"Set the bid optimization of a Sponsored Display ad group with `optimization.goalSettings.kpi` on `AMAZON_ADS_AD_GROUPS_ADD`:\n\n| `kpi`       | Optimization                            |\n| ----------- | --------------------------------------- |\n| `PURCHASES` | Conversions                             |\n| `CLICKS`    | Page visits (Amazon default if omitted) |\n| `REACH`     | Viewable impressions                    |\n\n`optimization` accepts only `bidStrategy`, `budgetSettings`, and `goalSettings.kpi`; other keys (for example `bidOptimization`) are rejected. Amazon may ignore a changed KPI on `AMAZON_ADS_AD_GROUPS_UPDATE`, so check it with `AMAZON_ADS_AD_GROUPS_FIND`. If it did not change, create a new ad group with the right KPI. Optimization cannot be set on Sponsored Display campaigns."},{"id":"sponsored-display-ads","title":"Sponsored Display ads","markdown":"`AMAZON_ADS_ADS_ADD` for `SPONSORED_DISPLAY` (`adType: \"COMPONENT\"`) creates product ads. Each ad advertises exactly one product: `creative.sku`, `creative.asin`, or `creative.componentCreative.responsiveEcommerceSettings.products[0]` with `productId` and `productIdType`. Send one ad item per product. Amazon builds the creative from the product detail page, so custom creative settings (logos, headlines, images, `assetBasedCreativeSettings`) are not supported. Sellers advertise SKUs; for Seller Central accounts an ASIN is resolved to a SKU from synced listings data. Vendors advertise ASINs. Do not send `marketplaces`, `marketplaceScope`, `marketplaceConfigurations`, or product `marketplaceSettings`; the marketplace comes from the Ads profile."},{"id":"mixed-ad-products-in-add-update-and-remove-actions","title":"Mixed ad products in add, update, and remove actions","markdown":"Amazon does not accept campaigns, ad groups, ads, or targets from different ad products in one write request. Add, update, and remove actions can still mix them: DataDoe splits the items by `adProduct` and sends one request per product. If one of these requests fails, only its items fail. Add items always carry `adProduct`. On update and remove, if an item has no `adProduct`, DataDoe looks it up by ID; an ID that is not found for the Ads profile fails only that item."},{"id":"sponsored-products-auto-campaigns","title":"Sponsored Products Auto campaigns","markdown":"Automatic vs manual targeting is locked when the campaign is created. Use `AMAZON_ADS_CAMPAIGNS_ADD` with `targetingType: \"AUTO\"` (preferred) or `autoCreationSettings.autoCreateTargets: true`. Then create an ad group and at least one product ad. Amazon creates the four Auto theme targets (Close Match, Loose Match, Substitutes, Complements). List them with `AMAZON_ADS_TARGETS_FIND` and optionally set bids with `AMAZON_ADS_TARGETS_UPDATE` or `AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND`. Amazon does not allow creating these targets, so `AMAZON_ADS_TARGETS_ADD` rejects positive `THEME` targets with these match types.\n\nDo not set `targetingType` or `autoCreationSettings` on `AMAZON_ADS_CAMPAIGNS_UPDATE`. To change Auto vs Manual, create a new campaign."},{"id":"negative-targeting","title":"Negative targeting","markdown":"Negatives use `AMAZON_ADS_TARGETS_ADD` with `negative: true`. Ad-group level uses `adGroupId`. Campaign level uses `campaignId`. Do not send a bid on negatives.\n\nNegative keyword:\n\n```json\n{\n    \"adProduct\": \"SPONSORED_PRODUCTS\",\n    \"state\": \"ENABLED\",\n    \"negative\": true,\n    \"targetType\": \"KEYWORD\",\n    \"adGroupId\": \"217994746792262\",\n    \"targetDetails\": {\n        \"keywordTarget\": {\n            \"keyword\": \"cheap\",\n            \"matchType\": \"EXACT\"\n        }\n    }\n}\n```\n\nNegative ASIN:\n\n```json\n{\n    \"adProduct\": \"SPONSORED_PRODUCTS\",\n    \"state\": \"ENABLED\",\n    \"negative\": true,\n    \"targetType\": \"PRODUCT\",\n    \"adGroupId\": \"217994746792262\",\n    \"targetDetails\": {\n        \"productTarget\": {\n            \"matchType\": \"PRODUCT_EXACT\",\n            \"productIdType\": \"ASIN\",\n            \"product\": { \"productId\": \"B0895LY6F1\" }\n        }\n    }\n}\n```\n\nSponsored Products v3 expression types map to DataDoe as follows:\n\n| Amazon SP v3 expression                        | DataDoe `targetType` | DataDoe `targetDetails`                                                                                          |\n| ---------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------- |\n| `ASIN_SAME_AS`                                 | `PRODUCT`            | `productTarget.matchType: PRODUCT_EXACT`                                                                         |\n| `ASIN_EXPANDED_FROM`                           | `PRODUCT`            | `productTarget.matchType: PRODUCT_SIMILAR`                                                                       |\n| `ASIN_BRAND_SAME_AS` / `ASIN_CATEGORY_SAME_AS` | `PRODUCT_CATEGORY`   | `productCategoryTarget.productCategoryRefinement.productCategoryRefinement.productBrandId` / `productCategoryId` |\n\nAmazon's public Sponsored Products v3 `expression` format is not the DataDoe contract; DataDoe follows Amazon Ads API v1."}]},{"id":"ads-budget-bid-rules","label":"Budget and bid rules","platform":"AMAZON_ADS","description":null,"guides":[{"id":"manage-budget-rules","title":"Manage budget rules","markdown":"Budget rule Actions use separate types for Sponsored Products (`SP`), Sponsored Brands (`SB`), and Sponsored Display (`SD`). A `SCHEDULE` rule increases a Campaign's daily budget during a date range or an Amazon event. A `PERFORMANCE` rule increases it when the Campaign meets a metric threshold. Create a rule, then associate its returned `ruleId` with one or more Campaigns of the same ad product.\n\nDataDoe stores existing budget rules, including rules created in the Amazon Ads console, in `amazon_ads_budget_rules`. Campaign attachments for Sponsored Products, Sponsored Brands, and Sponsored Display are in `amazon_ads_budget_rule_campaigns`. On the daily campaign and placement tables, join `ad_campaign_applicable_budget_rule_id` to `budget_rule_id`. `ad_campaign_applicable_budget_rule_name` matches `budget_rule_name`.\n\nSend rule definitions in `details.budgetRules` when creating rules. To update a rule, send its `ruleId` and either `ruleState`, `ruleDetails`, or both. Include only the fields you want to change in `ruleDetails`. Use `ruleState: \"PAUSED\"` to stop a rule from being evaluated, or `\"ACTIVE\"` to enable it again.\n\nEach rule definition needs `name`, `ruleType`, `budgetIncreaseBy`, and `duration`. Use `budgetIncreaseBy.type: \"PERCENT\"` with a positive `value`. Provide exactly one of `duration.dateRangeTypeRuleDuration` and `duration.eventTypeRuleDuration`. Dates use `YYYYMMDD`; the end date is inclusive and must be on or after the start date. An event duration uses an Amazon `eventId`. Unknown fields and read-only fields are rejected.\n\nOptional `recurrence.type` is `DAILY` or `WEEKLY` for Sponsored Products, Sponsored Brands and Sponsored Display. A weekly schedule needs `daysOfWeek`, such as `[\"SATURDAY\", \"SUNDAY\"]`. A daily schedule does not accept `daysOfWeek`. To pause or resume a rule and leave its schedule unchanged, send `ruleId` and `ruleState` only. An optional `intraDaySchedule` contains one time window with `startTime` and `endTime` in `HH:mm:ss` format; the end time must be later than the start time.\n\nPerformance rules also need `performanceMeasureCondition` with `metricName`, `comparisonOperator`, and `threshold`. Sponsored Products and Sponsored Display accept `ACOS`, `CTR`, `CVR`, and `ROAS`; Sponsored Brands accepts `IS`, `NTB`, and `ROAS`. Schedule rules omit `performanceMeasureCondition`.\n\nFor example, create a Sponsored Products schedule rule through `POST /api/v1/actions`:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_SP_BUDGET_RULES_ADD\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"budgetRules\": [\n            {\n                \"name\": \"Holiday budget increase\",\n                \"ruleType\": \"SCHEDULE\",\n                \"budgetIncreaseBy\": { \"type\": \"PERCENT\", \"value\": 20 },\n                \"duration\": {\n                    \"dateRangeTypeRuleDuration\": {\n                        \"startDate\": \"20261201\",\n                        \"endDate\": \"20261231\"\n                    }\n                },\n                \"recurrence\": { \"type\": \"DAILY\" }\n            }\n        ]\n    }\n}\n```\n\nAfter creating the rule in live mode, associate the returned ID using `AMAZON_ADS_SP_BUDGET_RULES_ASSOCIATE` and these details:\n\n```json\n{\n    \"associations\": [\n        {\n            \"campaignId\": \"123456789012345\",\n            \"budgetRuleIds\": [\"your-budget-rule-id\"]\n        }\n    ]\n}\n```\n\nTo pause the rule, use the matching `BUDGET_RULES_UPDATE` Action with these details:\n\n```json\n{\n    \"budgetRules\": [{ \"ruleId\": \"your-budget-rule-id\", \"ruleState\": \"PAUSED\" }]\n}\n```\n\nAssociation limits count the total rule IDs across all Campaigns in the Action: 25 through the API or 10 through MCP. A batch may have both successful and failed items; inspect the outcome for each item in the Action result.\n\nUse `AMAZON_ADS_SP_BUDGET_RULES_REMOVE`, `AMAZON_ADS_SB_BUDGET_RULES_REMOVE`, or `AMAZON_ADS_SD_BUDGET_RULES_REMOVE` to remove a rule from a Campaign. This removes that association and keeps the rule available for other Campaigns. For example, send these details:\n\n```json\n{\n    \"removals\": [\n        {\n            \"campaignId\": \"123456789012345\",\n            \"budgetRuleId\": \"your-budget-rule-id\"\n        }\n    ]\n}\n```\n\nDataDoe spaces requests to each budget rule endpoint at one request per second for each Ads profile. Amazon applies dynamic limits. For a throttled request, DataDoe honors Amazon's `Retry-After` header when present and retries up to twice within the 30-second request deadline. If the request still fails, the Action result message includes Amazon's message for each failed item."},{"id":"audit-budget-rule-executions","title":"Audit budget rule executions","markdown":"Amazon retired the `budgetRules/budgetHistory` endpoints for all three ad products on 31 August 2023 and lists no replacement in its [API deprecations notice](https://advertising.amazon.com/API/docs/en-us/release-notes/deprecations). Budget rule execution history is unavailable through Actions. The Action history records DataDoe requests to create, update, associate, or remove rules from Campaigns; it does not record Amazon's daily rule evaluations."},{"id":"manage-scheduled-bid-increases","title":"Manage scheduled bid increases","markdown":"Sponsored Products scheduled bid rules increase bids during a clock-time window. Dayparting means raising bids during set hours, and these Actions are useful for that. Amazon applies the schedule. DataDoe does not send a bid update each time the window starts or ends.\n\nCreate a rule with `AMAZON_ADS_SP_BID_RULES_ADD`, then attach the returned optimization rule ID with `AMAZON_ADS_SP_BID_RULES_ASSOCIATE`. Creating a rule does not attach it to a Campaign. These Actions are separate from budget rules and from Sponsored Products ROAS optimization rules.\n\nEach created rule needs `ruleName`, `bidIncreasePercent`, `duration`, and `recurrence`. `bidIncreasePercent` is a whole number from 1 to 100. DataDoe sends Amazon an increase of that percentage. Optional `status` is `ENABLED` or `PAUSED`. When `status` is omitted, DataDoe sends `ENABLED`.\n\n`recurrence.type` is `DAILY` or `WEEKLY`. A weekly schedule needs `daysOfWeek`. A daily schedule does not accept `daysOfWeek`. Optional `timesOfDay` is one window. `startTime` and `endTime` are hours in `HH:00` in the Amazon Ads profile timezone. `endTime` may be `24:00` and must be later than `startTime`. `duration.startTime` and optional `duration.endTime` are absolute ISO-8601 timestamps with a timezone, such as `2026-12-01T00:00:00Z`. When you change a schedule, send `duration` and `recurrence` together. An update loads the current rule and sends Amazon the complete rule, including the name, percentage, and schedule you did not change.\n\nThere is no Action to unlink a rule from one Campaign or to delete a rule. Pause or resume a rule with `AMAZON_ADS_SP_BID_RULES_UPDATE` and `status`. Pausing stops that rule for every Campaign that uses it. It does not remove the association.\n\nSearch with `AMAZON_ADS_SP_BID_RULES_FIND`. Send either `optimizationRuleIds` or one `campaignId`, not both. A Campaign search returns only scheduled bid rules for that Campaign. There is no search that lists every rule. `pageSize` is from 1 to 100, and DataDoe sends it to Amazon as `maxResults`. When the result includes `nextToken`, send it again with the same filters.\n\nFor example, increase bids by 20 percent on Saturday and Sunday from 17:00 to 21:00 through `POST /api/v1/actions`:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_SP_BID_RULES_ADD\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"bidRules\": [\n            {\n                \"ruleName\": \"Weekend evening increase\",\n                \"bidIncreasePercent\": 20,\n                \"duration\": {\n                    \"startTime\": \"2026-12-01T00:00:00Z\",\n                    \"endTime\": \"2026-12-31T23:59:59Z\"\n                },\n                \"recurrence\": {\n                    \"type\": \"WEEKLY\",\n                    \"daysOfWeek\": [\"SATURDAY\", \"SUNDAY\"],\n                    \"timesOfDay\": [{ \"startTime\": \"17:00\", \"endTime\": \"21:00\" }]\n                }\n            }\n        ]\n    }\n}\n```\n\nAfter creating the rule in live mode, associate the returned ID:\n\n```json\n{\n    \"associations\": [\n        {\n            \"campaignId\": \"123456789012345\",\n            \"optimizationRuleIds\": [\"your-optimization-rule-id\"]\n        }\n    ]\n}\n```\n\nTo pause the rule for every associated Campaign:\n\n```json\n{\n    \"bidRules\": [{ \"optimizationRuleId\": \"your-optimization-rule-id\", \"status\": \"PAUSED\" }]\n}\n```\n\nCreate and update batches allow 25 rules through the API or 10 through MCP. Association limits count the campaign-rule pairs in the Action. A batch may contain both successful and failed items. Amazon can reject a rule when the profile or Campaign is not eligible; the Action result includes Amazon's message. DataDoe spaces scheduled bid rule requests at one request per second for each Ads profile, separately from budget rule requests."}]},{"id":"ads-recommendations-insights","label":"Recommendations and insights","platform":"AMAZON_ADS","description":null,"guides":[{"id":"bids-before-launching-a-campaign","title":"Bids before launching a campaign","markdown":"**Eligibility: Sponsored Products advertisers (sellers and vendors). Requires Ads permission `advertiser_campaign_edit` or `advertiser_campaign_view`. Source: [Sponsored Products API reference](https://advertising.amazon.com/API/docs/en-us/sponsored-products/3-0/openapi/prod).** `POST /sp/targets/bid/recommendations` is available in marketplaces where Sponsored Products is available. Amazon returns HTTP 422 for an unsupported marketplace or an ineligible product. DataDoe reports that error on the item and does not invent a bid.\n\n`AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND` accepts two item modes in `details.bidRecommendations`. An existing ad group sends `adGroupId` and `targetings`. A new ad group sends `asins`, `targetings`, and `bidding`, with no `adGroupId`. Supply exactly one mode. `bidding` is rejected on an existing ad group because that ad group uses its campaign's strategy.\n\n`asins` is 1 to 50 unique uppercase 10-character ASINs. `targetings` reuses the existing expression list, including `KEYWORD_EXACT_MATCH`, `KEYWORD_PHRASE_MATCH`, and `KEYWORD_BROAD_MATCH`. Keyword expressions need a nonempty value. `bidding.strategy` is `LEGACY_FOR_SALES` (dynamic bids, down only), `AUTO_FOR_SALES` (dynamic bids, up and down), `MANUAL` (fixed bids), or `RULE_BASED`. Optional `bidding.adjustments` uses `PLACEMENT_TOP`, `PLACEMENT_REST_OF_SEARCH`, and `PLACEMENT_PRODUCT_PAGE`, at most one of each, with an integer `percentage` from 0 to 900.\n\n```json\n{\n    \"type\": \"AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"bidRecommendations\": [\n            {\n                \"asins\": [\"B012345678\"],\n                \"targetings\": [\n                    { \"type\": \"KEYWORD_EXACT_MATCH\", \"value\": \"stainless steel bottle\" },\n                    { \"type\": \"KEYWORD_PHRASE_MATCH\", \"value\": \"water bottle\" }\n                ],\n                \"bidding\": { \"strategy\": \"AUTO_FOR_SALES\" }\n            }\n        ]\n    }\n}\n```\n\nThe ASIN above is illustrative. Use an eligible product from an authorized Ads account. A multi-ASIN item is one recommendation group. Results and errors keep the original index and the input ASINs. DataDoe does not add campaign or ad group ids for this mode. Suggested bids can differ from the Ads console because strategy, placement settings, timing, and product eligibility all affect them.\n\n`AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND` ASIN items accept optional `biddingStrategy` with the same four values. Omit it to keep Amazon's default, `LEGACY_FOR_SALES`. Ad group items reject `biddingStrategy`. An explicit strategy is sent only on keyword recommendation version 5. That version is available in US, CA, BR, MX, UK, DE, FR, ES, IN, IT, NL, AE, SA, TR, EG, BE, SE, PL, JP, AU, and SG. Elsewhere the item fails with an unsupported-version error. DataDoe does not drop the strategy and retry an older version.\n\nCurrency units are not the same on every response. On keyword recommendation version 5, `bidInfo[].bid` is in minor currency units, such as cents. The spec does not state a unit for keyword `bidInfo[].suggestedBid` or for bid-recommendation `suggestedBid`. DataDoe returns Amazon's numbers unchanged and does not convert them. Compare a live response with the console before treating those fields as cents."}]},{"id":"ads-audiences","label":"Audiences","platform":"AMAZON_ADS","description":null,"guides":[{"id":"create-amc-audiences-for-sponsored-ads","title":"Create AMC audiences for Sponsored Ads","markdown":"AMC audiences are groups of shoppers that you select with SQL in [Amazon Marketing Cloud](/hub/docs/datadoe-features/amc), for example shoppers who added a product to the cart but did not buy it. You can use them in Sponsored Products and Sponsored Brands to increase bids for these shoppers, and in Sponsored Display to target them. DSP audiences are not supported.\n\nAMC audience Actions run in the AMC instance of the Seller or Vendor, so [enable AMC](/hub/docs/datadoe-features/amc) for it first. Without AMC, the Actions return HTTP 412 with a message that explains what is missing.\n\n- `AMAZON_ADS_AMC_AUDIENCES_ADD` creates a rule-based audience from SQL. The final `SELECT` must return only `user_id`, and the tables must be AMC audience tables, whose names end in `_for_audiences` (for example `conversions_for_audiences` or `sponsored_ads_traffic_for_audiences`). Amazon fails an audience with fewer than 2,000 shoppers, so check the size first with an AMC query on the matching table without `_for_audiences`.\n- `AMAZON_ADS_AMC_LOOKALIKE_AUDIENCES_ADD` creates a lookalike audience from a seed query of 500 to 500,000 shoppers. `lookalikeAudienceExpectedReach` sets how broad it is, from `MOST_SIMILAR` (about 0.5 to 1 million shoppers) to `MOST_BROAD` (about 3 to 10 million).\n- `timeWindowStart` and `timeWindowEnd` are UTC date and times ending in `Z`. With `timeWindowRelative: true`, Amazon moves the window forward on each refresh.\n\nAmazon builds an audience in the background, and DataDoe does not attach it to campaigns later on its own. Your AI agent or integration takes these steps:\n\n1. Create the audience. The result includes its `audienceExecutionId`.\n2. Check it with `AMAZON_ADS_AMC_AUDIENCES_FIND` every 15 to 30 minutes until `status` is `SUCCEEDED`. When it is `FAILED`, `statusReason` explains why. Fix the audience with `AMAZON_ADS_AMC_AUDIENCES_UPDATE`.\n3. Amazon lists a `SUCCEEDED` audience in Sponsored Ads after about 24 to 48 hours. Get its Sponsored Ads `audienceId` with `AMAZON_ADS_TARGETABLE_AUDIENCES_FIND`, using the ad product and the audience name. When the audience is not listed yet, try again later.\n4. Attach the `audienceId`: in Sponsored Products and Sponsored Brands with `audienceBidAdjustments` in `AMAZON_ADS_CAMPAIGNS_UPDATE`, or in Sponsored Display with an `AUDIENCE` target in `AMAZON_ADS_TARGETS_ADD` (`audienceTarget.audienceId.defaultValue`).\n\n`AMAZON_ADS_AMC_AUDIENCES_UPDATE` works only for `FAILED` audiences. It can change the SQL and the time window; the name, description, and lookalike reach stay as they are. `AMAZON_ADS_AMC_AUDIENCES_REMOVE` deletes `FAILED` or `SUCCEEDED` audiences, and Amazon also removes them from Sponsored Ads.\n\nFor example, create an audience of shoppers who added a product to the cart but did not buy it after that (the query from Amazon's AMC instructional queries), through `POST /api/v1/actions`:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_AMC_AUDIENCES_ADD\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"audiences\": [\n            {\n                \"audienceName\": \"Cart abandoners 30 days\",\n                \"sql\": \"WITH purchase AS (SELECT user_id, MAX(event_dt_utc) AS purchase_dt_max FROM conversions_for_audiences WHERE event_subtype = 'order' GROUP BY 1), atc AS (SELECT user_id, MAX(event_dt_utc) AS atc_dt_max FROM conversions_for_audiences WHERE event_subtype = 'shoppingCart' GROUP BY 1) SELECT atc.user_id FROM atc LEFT JOIN purchase ON atc.user_id = purchase.user_id WHERE atc_dt_max > purchase_dt_max OR purchase_dt_max IS NULL\",\n                \"timeWindowStart\": \"2026-09-20T00:00:00Z\",\n                \"timeWindowEnd\": \"2026-10-19T00:00:00Z\",\n                \"timeWindowRelative\": true\n            }\n        ]\n    }\n}\n```\n\nWhen the audience is listed in Sponsored Ads, find its `audienceId` with `AMAZON_ADS_TARGETABLE_AUDIENCES_FIND`:\n\n```json\n{\n    \"adProduct\": \"SPONSORED_PRODUCTS\",\n    \"audienceName\": \"Cart abandoners 30 days\"\n}\n```\n\nThen increase bids for it by 30 percent in a Sponsored Products campaign with `AMAZON_ADS_CAMPAIGNS_UPDATE`:\n\n```json\n{\n    \"campaigns\": [\n        {\n            \"campaignId\": \"123456789012345\",\n            \"adProduct\": \"SPONSORED_PRODUCTS\",\n            \"audienceBidAdjustments\": [{ \"audienceId\": \"your-audience-id\", \"percentage\": 30 }]\n        }\n    ]\n}\n```\n\nOne Action creates, updates, or deletes up to 10 audiences through the API and 5 through MCP. Creating or updating an audience costs 5 AI Tokens per audience (currently promotional 0). Finding and deleting audiences is free. See [Subscription and pricing](/hub/docs/basics/subscription-pricing)."},{"id":"audience-prices","title":"Audience prices","markdown":"`AMAZON_LISTINGS_PRICING_UPDATE` sets the single-unit price for one audience on a Seller Central listing. Omit `audience`, or set it to `ALL`, to set the price every buyer pays.\n\nUse `B2B` for Amazon Business buyers. Use an industry audience, such as `B2B_EDUCATION`, for business industry pricing (IVP). Amazon documents these audiences for the United States, and from 15 October 2026 also for Canada, the UK, Germany, France, Italy, Spain, and Japan. `ALL` works in every marketplace.\n\nIndustry audiences are available when the seller is enrolled in Amazon Business. Amazon calls this subscription SellingToBusinesses. The audiences a seller can use are on the product-type schema for that seller and marketplace. Load it with `AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND`. Send that product type on the price change. DataDoe checks the audience, price, and quantity discounts against that schema.\n\nA price change merges the selected audience, currency, and marketplace. Other audiences stay as they are. Quantity discounts, price limits, and automated pricing rules stay as they are unless you send a new quantity-discount plan. If Seller Central has an automated pricing rule for that audience, Amazon applies the rule instead of the price you send.\n\n`quantityDiscount` is for an Amazon Business or industry audience. `discountType` is `percent` or `fixed`. When `discountType` is `percent`, 5 means 5% off the single-unit price. When `discountType` is `fixed`, `value` is the unit price buyers pay in the marketplace currency once the order reaches `lowerBound`. `lowerBound` is the minimum quantity for that tier. Omit `quantityDiscount` to leave the current tiers in place.\n\nYou can send more than one audience for the same SKU. DataDoe sends them in one price update. Do not repeat the same audience for a SKU.\n\nRead current audience prices from `amazon_listings_audience_pricing`. One row is one connection, marketplace, SKU, and audience. `unit_price` is the single-unit price. `quantity_discount_tiers` lists those tiers. When `discount_type` is `percent`, `value` is the percent off the single-unit price. When `discount_type` is `fixed`, `value` is the unit price.\n\nTo check a price before you send it, run `dryRun`, then `AMAZON_LISTINGS_PRICING_UPDATE_VERIFY`, then `AMAZON_LISTINGS_PRICING_UPDATE`. When the change includes `productType`, `dryRun` checks the product-type schema. The verify Action asks Amazon to preview the price with replace, because validation preview does not accept merge. It does not change the price. The price update still merges that audience only."}]},{"id":"ads-brands-creative-assets","label":"Brands and creative assets","platform":"AMAZON_ADS","description":null,"guides":[{"id":"upload-and-find-creative-assets","title":"Upload and find creative assets","markdown":"Creative assets are images and videos in Amazon's Creative Asset Library. Upload a file first, then start `AMAZON_ADS_ASSETS_ADD`. The action stays in processing until Amazon finishes spec checks.\n\nEligibility follows Amazon's published coverage:\n\n- Console launch on 2021-07-15: vendors, sellers, and KDP authors in the US, CA, and MX. [Creative assets](https://advertising.amazon.com/resources/whats-new/creative-assets)\n- Sponsored Display and Ads API expansion on 2022-04-19: vendors and registered sellers in the US, CA, MX, BR, DE, ES, FR, IT, NL, UK, AE, AU, IN, and JP. [Sponsored Display creative assets](https://advertising.amazon.com/resources/whats-new/sponsored-display-creative-assets)\n\nCreate the file with `POST /files` in group `AD_ASSETS` (`PNG`, `JPG`, `MP4`, or `MOV`, up to 500MB), then `PUT` the bytes to the returned `uploadUrl` within 30 minutes. DataDoe then handles Amazon's own upload URL, which expires after 15 minutes, while the action runs. For video, MCP `files_create` should use `uploadMode: UPLOAD_URL`, which returns `{ file, uploadUrl }` and does not require `contentBase64`. Inline MCP upload stays limited to the smaller image size.\n\n`AMAZON_ADS_ASSETS_ADD` uploads each file and registers it. Images can take up to 1 hour and videos up to 6 hours before the action completes. The result lists each file in `items` with its `assetId`, `assetVersion`, status, and spec-check `issues`. A failed action keeps `items` too, so assets Amazon already registered stay usable. Sellers must set `brandEntityId` (look it up with `AMAZON_ADS_BRANDS_FIND`). Vendors may omit it. `AMAZON_ADS_ASSETS_FIND` looks up assets by id or returns one search page plus `nextToken`.\n\nDSP creative-asset upload is not available until DSP actions ship. Do not send `adProduct: AMAZON_DSP`."}]},{"id":"ads-attribution","label":"Attribution","platform":"AMAZON_ADS","description":null,"guides":[]},{"id":"ads-account-communication","label":"Account communication","platform":"AMAZON_ADS","description":null,"guides":[{"id":"manage-communication-contacts-and-preferences-amazon-open-beta","title":"Manage communication contacts and preferences (Amazon open beta)","markdown":"These four Actions use Amazon's [Communications Preferences API](https://advertising.amazon.com/API/docs/en-us/guides/communications-preferences/get-started), which Amazon released as an open beta on 1 October 2026. Amazon may change it before general availability. The connected Amazon Ads user needs the account view permission for FIND and the account edit permission for ADD and UPDATE. These differ from the campaign permissions other Ads Actions use. Without them, the Action fails with a permission message. Communication preferences belong to the Amazon Ads profile of the Seller or Vendor: in DataDoe's tests, two marketplaces on the same Amazon Ads account had separate preferences with different IDs. Run FIND and UPDATE for each Seller or Vendor whose preferences you want to change. Amazon does not document whether contacts apply to one profile or to the whole Amazon Ads account.\n\n`AMAZON_ADS_COMMUNICATION_CONTACTS_ADD` registers account support contacts. Amazon cannot edit or delete a contact through the API, so run the Action with `dryRun` first. Each contact has a `channel` (`EMAIL` or `PHONE`) and a `contactAddress` with exactly one of `emailAddress` or `phoneNumber`. Phone numbers use E.164, such as `+442071234567`. `contactPurpose` defaults to `ACCOUNT_SUPPORT`, the only purpose Amazon accepts. Optional `timeZone` accepts only Amazon's list of 44 IANA zones; zones such as `Europe/Warsaw` or `Europe/Berlin` are rejected. DataDoe first lists the existing contacts and skips an address that already exists, returning it with `alreadyExists: true`. Other contacts are sent one per Amazon request. If Amazon lists more than 500 contacts on a channel, DataDoe cannot check them all, so the Action fails before adding any contact.\n\n`AMAZON_ADS_COMMUNICATION_CONTACTS_FIND` and `AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND` take one `channel`, plus optional `maxResults` (1 to 100) and `nextToken`. Contacts use `EMAIL` or `PHONE`. Preferences use `EMAIL` or `UI` (in-app messages).\n\nCategory IDs are not fixed values. Get `communicationPreferenceId` and `categoryId` from `AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND`, then update with `AMAZON_ADS_COMMUNICATION_PREFERENCES_UPDATE`. `communicationsEnabled` is required. When it is `true`, send at least one `categoryPreferences` entry; Amazon would otherwise subscribe the account to every category. Send `communicationsEnabled: false` to stop every communication on that channel. DataDoe checks the IDs against the current preferences and sends Amazon the full category list: the current subscriptions with your changes applied. Categories you omit keep their current state. Each result item contains Amazon's updated `communicationPreference` and the `previousCommunicationPreference`.\n\nFor example, list email preferences:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"details\": { \"channel\": \"EMAIL\" }\n}\n```\n\nThen unsubscribe from one category and keep the channel enabled:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_COMMUNICATION_PREFERENCES_UPDATE\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"communicationPreferences\": [\n            {\n                \"communicationPreferenceId\": \"your-communication-preference-id\",\n                \"communicationsEnabled\": true,\n                \"categoryPreferences\": [\n                    { \"categoryId\": \"your-category-id\", \"isCategorySubscribed\": false }\n                ]\n            }\n        ]\n    }\n}\n```\n\nAdd an email contact for account support:\n\n```json\n{\n    \"type\": \"AMAZON_ADS_COMMUNICATION_CONTACTS_ADD\",\n    \"sellerOrVendorId\": \"your-seller-or-vendor-id\",\n    \"dryRun\": true,\n    \"details\": {\n        \"communicationContacts\": [\n            {\n                \"channel\": \"EMAIL\",\n                \"contactAddress\": { \"emailAddress\": \"ads-team@example.com\" },\n                \"preferredContact\": true,\n                \"timeZone\": \"Europe/London\"\n            }\n        ]\n    }\n}\n```\n\nADD accepts 5 contacts and UPDATE 2 preferences, through the API and MCP. DataDoe masks email addresses and phone numbers in its internal Amazon Ads call logs. The Action details and result keep the full values."}]},{"id":"ads-partner-opportunities","label":"Partner opportunities","platform":"AMAZON_ADS","description":"Partner Network opportunities and Amazon account team recommendations. See [Amazon Ads Partner Opportunities](/hub/docs/datadoe-data/amazon-ads-partner-opportunities) for the Partner Network setup.","guides":[{"id":"partner-network-recommendations","title":"Partner Network recommendations","markdown":"These are Amazon recommendations. Find, apply, and status Actions use a Partner Network account ID saved on the Amazon Ads connection.\n\n- `AMAZON_ADS_PARTNER_OPPORTUNITIES_FIND` returns one catalog page, not the recommendation rows\n- read recommendation rows from `amazon_ads_partner_opportunities` after the daily sync\n- `AMAZON_ADS_PARTNER_RECOMMENDATIONS_APPLY` sends 1 to 100 recommendation IDs from one account-team opportunity\n- dry run does not call Amazon, and HTTP 202 means Amazon accepted the request\n- HTTP 202 does not mean the change is complete\n- `AMAZON_ADS_PARTNER_RECOMMENDATION_STATUS_FIND` reads status for 1 to 500 IDs and does not apply them again\n\nSee [Amazon Ads Partner Opportunities](/hub/docs/datadoe-data/amazon-ads-partner-opportunities) for setup, the nine families, and why a table can be empty."}]}],"actions":[{"type":"AMAZON_LISTINGS_CREATE","label":"Create listing","group":"listings","entity":"Listings","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":20},"description":"Create Amazon listings or offers on existing ASINs, including [images](/hub/docs/datadoe-features/actions-manage-images).","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing create feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsCreateChange"}}},"required":["changes"],"additionalProperties":false,"$defs":{"ActionRequestListingsCreateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to create"},"productType":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon product type of the listing, for example LUGGAGE."},"requirements":{"description":"Amazon requirements set for this change. LISTING creates a full listing. LISTING_OFFER_ONLY adds an offer on an existing ASIN. LISTING_PRODUCT_ONLY sends product data without an offer. Omitted means LISTING.","type":"string","enum":["LISTING","LISTING_PRODUCT_ONLY","LISTING_OFFER_ONLY"]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Amazon listing attributes for the selected requirements set. Do not include image locator attributes (main_product_image_locator, other_product_image_locator_*); use images instead."},"images":{"description":"Listing images for create. Upload images via Files API (group LISTING_IMAGES) for the same seller or vendor, then reference file UUIDs. Do not put image locator media_location values in attributes.","anyOf":[{"$ref":"#/$defs/ActionRequestListingsCreateImages"},{"type":"null"}]}},"required":["sku","productType","attributes"],"additionalProperties":false},"ActionRequestListingsCreateImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false,"$ref":"#/$defs/ActionRequestListingImages"},"ActionRequestListingImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_DELETE","label":"Delete listing","group":"listings","entity":"Listings","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Delete Amazon listings by SKU, including a parent SKU.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing delete feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"skus":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to delete."},"description":"SKUs to delete. DataDoe sends one JSON listings feed message per SKU with operationType DELETE. Do not send a product type or attributes. DataDoe rejects duplicate SKUs. dryRun checks this request and does not call Amazon."}},"required":["skus"],"additionalProperties":false}},{"type":"AMAZON_LISTINGS_UPDATE","label":"Update listing","group":"listings","entity":"Listings","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Easy way to update basic Amazon listing parameters, like name, bullet points, keywords, and [images](/hub/docs/datadoe-features/actions-manage-images).","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing update feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingChange"}}},"required":["changes"],"additionalProperties":false,"$defs":{"ActionRequestListingChange":{"type":"object","properties":{"sku":{"type":"string","maxLength":64,"description":"SKU of the listing to update"},"language_tag":{"description":"Language version of the listing to update as POSIX locale. Required when name, description, bulletPoints, genericKeyword, or itemHighlight is provided.","type":"string","minLength":2,"maxLength":16,"pattern":"^[a-z]{2,3}(_([A-Z]{2}|[0-9]{3}))?(@.+)?$"},"name":{"description":"Name to set for the listing","type":"string","maxLength":75},"description":{"description":"Description to set for the listing","type":"string","maxLength":4096},"bulletPoints":{"description":"Bullet points to set for the listing","maxItems":5,"type":"array","items":{"type":"string","maxLength":1000}},"genericKeyword":{"description":"Generic keyword to set for the listing","type":"string","maxLength":256},"itemTypeKeyword":{"description":"Item type keyword to set for the listing. Supported in all marketplaces.","type":"string","maxLength":256},"itemHighlight":{"description":"Item highlight to set for the listing. Maps to Amazon title_differentiation attribute.","type":"string","maxLength":125},"images":{"description":"Listing image updates. Upload images via Files API (group LISTING_IMAGES) for the same seller or vendor, then reference file UUIDs. Omitted image fields are left unchanged.","anyOf":[{"$ref":"#/$defs/ActionRequestListingImages"},{"type":"null"}]}},"required":["sku"],"additionalProperties":false},"ActionRequestListingImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_PRICING_UPDATE","label":"Update listing price","group":"listings","entity":"Listings","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Set the single-unit price for one audience. Audience defaults to ALL. You can set Amazon Business quantity-discount tiers. A merge update changes only that audience.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsPricingUpdateChange"}}},"required":["changes"],"additionalProperties":false,"$defs":{"ActionRequestListingsPricingUpdateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to update"},"price":{"type":"number","exclusiveMinimum":0,"maximum":99999.99,"description":"Single-unit price for this audience. Currency comes from the connection marketplace. Supported for Seller Central accounts only."},"audience":{"description":"Buyer audience. Omit or use ALL for every buyer. Use B2B for Amazon Business. Use an industry audience such as B2B_EDUCATION when the seller is enrolled in Amazon Business and the product-type schema lists that audience. Defaults to ALL.","type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"productType":{"description":"Amazon product type, for example LUGGAGE. Required when audience is not ALL or when quantity discounts are set, so DataDoe can check the offer against the current product-type schema for this seller and marketplace.","type":"string","minLength":1,"maxLength":64},"quantityDiscount":{"description":"Quantity discounts for an Amazon Business or industry audience. Omit to leave existing quantity discounts unchanged. Not allowed for audience ALL.","$ref":"#/$defs/ActionRequestListingsPricingQuantityDiscount"}},"required":["sku","price"],"additionalProperties":false},"ActionRequestListingsPricingQuantityDiscount":{"type":"object","properties":{"discountType":{"type":"string","enum":["percent","fixed"],"description":"percent is percentage points, so 5 means 5% off the single-unit price. fixed is the unit price for that tier, in the marketplace currency."},"levels":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsPricingQuantityDiscountLevel"}}},"required":["discountType","levels"],"additionalProperties":false},"ActionRequestListingsPricingQuantityDiscountLevel":{"type":"object","properties":{"lowerBound":{"type":"integer","exclusiveMinimum":0,"maximum":999999,"description":"Minimum quantity for this tier."},"value":{"type":"number","exclusiveMinimum":0,"maximum":99999.99,"description":"Percentage points off the single-unit price when discountType is percent. The unit price in the marketplace currency when discountType is fixed."}},"required":["lowerBound","value"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE","label":"Update listing details","group":"listings","entity":"Listings","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Advanced way to update arbitrary Amazon listing attributes.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing details update feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsDetailsUpdateChange"}}},"required":["changes"],"additionalProperties":false,"$defs":{"ActionRequestListingsDetailsUpdateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to update"},"productType":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon product type of the listing, for example LUGGAGE."},"change":{"$ref":"#/$defs/ActionRequestListingsDetailsUpdateChangePatch"}},"required":["sku","productType","change"],"additionalProperties":false},"ActionRequestListingsDetailsUpdateChangePatch":{"type":"object","properties":{"parameterName":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon listing attribute name to patch, for example item_name."},"operation":{"type":"string","enum":["REPLACE","DELETE","MERGE"],"description":"JSON Patch operation to apply to the attribute."},"value":{"description":"Attribute value for the patch. Required for REPLACE and MERGE. Must match the product type definition schema for parameterName."}},"required":["parameterName","operation"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_CREATE_VERIFY","label":"Preview listing create","group":"listings","entity":"Listings","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5,"mcp":5},"description":"Preview `AMAZON_LISTINGS_CREATE` with Amazon `VALIDATION_PREVIEW`. Does not create the listing. Returns Amazon status, submission ID, and issues.","result":"Amazon status, submission ID, and issues.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing create feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsCreateChange"}}},"required":["changes"],"additionalProperties":false,"description":"Previews AMAZON_LISTINGS_CREATE. Calls Amazon putListingsItem (Listings Items v2021-08-01) with mode=VALIDATION_PREVIEW and the same productType, requirements, and attributes the create Action would submit, including LISTING, LISTING_PRODUCT_ONLY, and LISTING_OFFER_ONLY. Does not create or replace the listing. Returns Amazon status, submissionId, and issues. dryRun checks the DataDoe request and the product-type schema and does not call Amazon. To check before a write, run dryRun, then this Action, then AMAZON_LISTINGS_CREATE. One SKU per Amazon call. Limits count distinct SKUs; all changes for a SKU are validated together. Not a bulk workflow.","$defs":{"ActionRequestListingsCreateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to create"},"productType":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon product type of the listing, for example LUGGAGE."},"requirements":{"description":"Amazon requirements set for this change. LISTING creates a full listing. LISTING_OFFER_ONLY adds an offer on an existing ASIN. LISTING_PRODUCT_ONLY sends product data without an offer. Omitted means LISTING.","type":"string","enum":["LISTING","LISTING_PRODUCT_ONLY","LISTING_OFFER_ONLY"]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Amazon listing attributes for the selected requirements set. Do not include image locator attributes (main_product_image_locator, other_product_image_locator_*); use images instead."},"images":{"description":"Listing images for create. Upload images via Files API (group LISTING_IMAGES) for the same seller or vendor, then reference file UUIDs. Do not put image locator media_location values in attributes.","anyOf":[{"$ref":"#/$defs/ActionRequestListingsCreateImages"},{"type":"null"}]}},"required":["sku","productType","attributes"],"additionalProperties":false},"ActionRequestListingsCreateImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false,"$ref":"#/$defs/ActionRequestListingImages"},"ActionRequestListingImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_UPDATE_VERIFY","label":"Preview listing update","group":"listings","entity":"Listings","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5,"mcp":5},"description":"Preview `AMAZON_LISTINGS_UPDATE` with Amazon `VALIDATION_PREVIEW`. Does not change the listing. Returns Amazon status, submission ID, and issues.","result":"Amazon status, submission ID, and issues.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing update feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingChange"},"description":"At most 5 distinct SKUs. All changes for each SKU are sent together in one Amazon validation preview request. At most 5000 changes in total."}},"required":["changes"],"additionalProperties":false,"description":"Previews AMAZON_LISTINGS_UPDATE. Calls Amazon patchListingsItem (Listings Items v2021-08-01) with mode=VALIDATION_PREVIEW and the same patches the update Action would submit. Does not change the listing. Returns Amazon status, submissionId, and issues. dryRun checks the DataDoe request and does not call Amazon. To check before a write, run dryRun, then this Action, then AMAZON_LISTINGS_UPDATE. One SKU per Amazon call. Limits count distinct SKUs; all changes for a SKU are validated together. Not a bulk workflow.","$defs":{"ActionRequestListingChange":{"type":"object","properties":{"sku":{"type":"string","maxLength":64,"description":"SKU of the listing to update"},"language_tag":{"description":"Language version of the listing to update as POSIX locale. Required when name, description, bulletPoints, genericKeyword, or itemHighlight is provided.","type":"string","minLength":2,"maxLength":16,"pattern":"^[a-z]{2,3}(_([A-Z]{2}|[0-9]{3}))?(@.+)?$"},"name":{"description":"Name to set for the listing","type":"string","maxLength":75},"description":{"description":"Description to set for the listing","type":"string","maxLength":4096},"bulletPoints":{"description":"Bullet points to set for the listing","maxItems":5,"type":"array","items":{"type":"string","maxLength":1000}},"genericKeyword":{"description":"Generic keyword to set for the listing","type":"string","maxLength":256},"itemTypeKeyword":{"description":"Item type keyword to set for the listing. Supported in all marketplaces.","type":"string","maxLength":256},"itemHighlight":{"description":"Item highlight to set for the listing. Maps to Amazon title_differentiation attribute.","type":"string","maxLength":125},"images":{"description":"Listing image updates. Upload images via Files API (group LISTING_IMAGES) for the same seller or vendor, then reference file UUIDs. Omitted image fields are left unchanged.","anyOf":[{"$ref":"#/$defs/ActionRequestListingImages"},{"type":"null"}]}},"required":["sku"],"additionalProperties":false},"ActionRequestListingImages":{"type":"object","properties":{"mainImage":{"description":"Main listing image. Maps to Amazon main_product_image_locator. Upload via Files API (group LISTING_IMAGES) first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image1":{"description":"Gallery image slot 1 (other_product_image_locator_1).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image2":{"description":"Gallery image slot 2 (other_product_image_locator_2).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image3":{"description":"Gallery image slot 3 (other_product_image_locator_3).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image4":{"description":"Gallery image slot 4 (other_product_image_locator_4).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image5":{"description":"Gallery image slot 5 (other_product_image_locator_5).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image6":{"description":"Gallery image slot 6 (other_product_image_locator_6).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image7":{"description":"Gallery image slot 7 (other_product_image_locator_7).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"image8":{"description":"Gallery image slot 8 (other_product_image_locator_8).","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"variationSwatchImage":{"description":"Variation swatch image. Maps to Amazon swatch_product_image_locator. Upload via Files API first, then pass the file UUID.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_PRICING_UPDATE_VERIFY","label":"Preview listing price update","group":"listings","entity":"Listings","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":5,"mcp":5},"description":"Preview `AMAZON_LISTINGS_PRICING_UPDATE` with Amazon `VALIDATION_PREVIEW`. Does not change the price. Returns Amazon status, submission ID, and issues.","result":"Amazon status, submission ID, and issues.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsPricingUpdateChange"},"description":"At most 5 distinct SKUs. All changes for each SKU are sent together in one Amazon validation preview request. At most 5000 changes in total."}},"required":["changes"],"additionalProperties":false,"description":"Previews AMAZON_LISTINGS_PRICING_UPDATE. Calls Amazon patchListingsItem (Listings Items v2021-08-01) with mode=VALIDATION_PREVIEW and the same audience prices the pricing update would send. Amazon validation preview does not accept merge, so the preview uses replace. The price update still merges that audience and leaves other audiences and omitted offer fields unchanged. Does not change the price. Returns Amazon status, submissionId, and issues, including pricing issues when the body contains price attributes. dryRun checks the DataDoe request and does not call Amazon. When a change includes productType, dryRun also checks that offer against the current product-type schema for the seller and marketplace. To check before a write, run dryRun, then this Action, then AMAZON_LISTINGS_PRICING_UPDATE. One SKU per Amazon call. Limits count distinct SKUs; all changes for a SKU are validated together. Not a bulk workflow. Seller Central only.","$defs":{"ActionRequestListingsPricingUpdateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to update"},"price":{"type":"number","exclusiveMinimum":0,"maximum":99999.99,"description":"Single-unit price for this audience. Currency comes from the connection marketplace. Supported for Seller Central accounts only."},"audience":{"description":"Buyer audience. Omit or use ALL for every buyer. Use B2B for Amazon Business. Use an industry audience such as B2B_EDUCATION when the seller is enrolled in Amazon Business and the product-type schema lists that audience. Defaults to ALL.","type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z][A-Za-z0-9_]*$"},"productType":{"description":"Amazon product type, for example LUGGAGE. Required when audience is not ALL or when quantity discounts are set, so DataDoe can check the offer against the current product-type schema for this seller and marketplace.","type":"string","minLength":1,"maxLength":64},"quantityDiscount":{"description":"Quantity discounts for an Amazon Business or industry audience. Omit to leave existing quantity discounts unchanged. Not allowed for audience ALL.","$ref":"#/$defs/ActionRequestListingsPricingQuantityDiscount"}},"required":["sku","price"],"additionalProperties":false},"ActionRequestListingsPricingQuantityDiscount":{"type":"object","properties":{"discountType":{"type":"string","enum":["percent","fixed"],"description":"percent is percentage points, so 5 means 5% off the single-unit price. fixed is the unit price for that tier, in the marketplace currency."},"levels":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsPricingQuantityDiscountLevel"}}},"required":["discountType","levels"],"additionalProperties":false},"ActionRequestListingsPricingQuantityDiscountLevel":{"type":"object","properties":{"lowerBound":{"type":"integer","exclusiveMinimum":0,"maximum":999999,"description":"Minimum quantity for this tier."},"value":{"type":"number","exclusiveMinimum":0,"maximum":99999.99,"description":"Percentage points off the single-unit price when discountType is percent. The unit price in the marketplace currency when discountType is fixed."}},"required":["lowerBound","value"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_DETAILS_UPDATE_VERIFY","label":"Preview listing details update","group":"listings","entity":"Listings","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5,"mcp":5},"description":"Preview `AMAZON_LISTINGS_DETAILS_UPDATE` with Amazon `VALIDATION_PREVIEW`. Does not change the listing. Returns Amazon status, submission ID, and issues.","result":"Amazon status, submission ID, and issues.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code for the listing details update feed header. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"changes":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsDetailsUpdateChange"},"description":"At most 5 distinct SKUs. All changes for each SKU are sent together in one Amazon validation preview request. At most 5000 changes in total."}},"required":["changes"],"additionalProperties":false,"description":"Previews AMAZON_LISTINGS_DETAILS_UPDATE. Calls Amazon patchListingsItem (Listings Items v2021-08-01) with mode=VALIDATION_PREVIEW and the same attribute values the details update would send. Amazon validation preview does not accept merge, so a merge change is previewed with replace. The details update still sends merge. Does not change the listing. Returns Amazon status, submissionId, and issues. dryRun checks the DataDoe request and the product-type schema and does not call Amazon. To check before a write, run dryRun, then this Action, then AMAZON_LISTINGS_DETAILS_UPDATE. One SKU per Amazon call. Limits count distinct SKUs; all changes for a SKU are validated together. Not a bulk workflow.","$defs":{"ActionRequestListingsDetailsUpdateChange":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"SKU of the listing to update"},"productType":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon product type of the listing, for example LUGGAGE."},"change":{"$ref":"#/$defs/ActionRequestListingsDetailsUpdateChangePatch"}},"required":["sku","productType","change"],"additionalProperties":false},"ActionRequestListingsDetailsUpdateChangePatch":{"type":"object","properties":{"parameterName":{"type":"string","minLength":1,"maxLength":64,"description":"Amazon listing attribute name to patch, for example item_name."},"operation":{"type":"string","enum":["REPLACE","DELETE","MERGE"],"description":"JSON Patch operation to apply to the attribute."},"value":{"description":"Attribute value for the patch. Required for REPLACE and MERGE. Must match the product type definition schema for parameterName."}},"required":["parameterName","operation"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_FIND","label":"Find listings","group":"listings","entity":"Listings","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":300},"description":"Find Amazon listings by given identifier (like SKU, ASIN, or UPC).","result":"Full models of found listings. Each item includes `content` with the title, description, keywords, highlight and up to five bullets.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code used as Listings Items API sellerId. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"listingIdentifiers":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsFindChange"}}},"required":["listingIdentifiers"],"additionalProperties":false,"$defs":{"ActionRequestListingsFindChange":{"type":"object","properties":{"identifierType":{"type":"string","enum":["ASIN","EAN","FNSKU","GTIN","ISBN","JAN","MINSAN","SKU","UPC"],"description":"Product identifier type accepted by the Amazon Listings Items search API."},"identifier":{"type":"string","minLength":1,"maxLength":64,"description":"Product identifier value to search for."}},"required":["identifierType","identifier"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_FEES_ESTIMATE","label":"Estimate listing fees","group":"listings","entity":"Pricing insights","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":2500,"mcp":300},"description":"Estimate Amazon listing fees for ASINs or SKUs at a given listing and shipping price.","result":"Estimated fee breakdown per item.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"feesEstimates":{"minItems":1,"maxItems":2500,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsFeesEstimateItem"}}},"required":["feesEstimates"],"additionalProperties":false,"$defs":{"ActionRequestListingsFeesEstimateItem":{"type":"object","properties":{"identifierType":{"type":"string","enum":["ASIN","SKU"],"description":"Product identifier type accepted by the Amazon Product Fees API."},"identifier":{"type":"string","minLength":1,"maxLength":64,"description":"Product identifier value to estimate fees for."},"isFBA":{"type":"boolean","description":"When true, the offer is fulfilled by Amazon."},"fbaProgram":{"description":"Optional FBA enrollment program when isFBA is true.","anyOf":[{"type":"string","enum":["FBA_CORE","FBA_SNL","FBA_EFN"]},{"type":"null"}]},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency code for price values."},"listingPriceValue":{"type":"number","minimum":0,"description":"Listing price amount used to estimate fees."},"shippingPriceValue":{"type":"number","minimum":0,"description":"Shipping price amount used to estimate fees."}},"required":["identifierType","identifier","isFBA","currency","listingPriceValue","shippingPriceValue"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE","label":"Estimate featured price","group":"listings","entity":"Pricing insights","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":120,"mcp":40},"description":"Estimate the featured offer expected price (FOEP) for seller SKUs. Supports an optional location segment (`countryCode` + `postalCode`). Does not guarantee Featured Offer placement.","result":"Full Amazon FOEP response body per SKU.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"featuredPriceEstimates":{"minItems":1,"maxItems":120,"type":"array","items":{"$ref":"#/$defs/ActionRequestFeaturedPriceEstimateItem"}}},"required":["featuredPriceEstimates"],"additionalProperties":false,"$defs":{"ActionRequestFeaturedPriceEstimateItem":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64,"description":"Seller SKU used to estimate the featured offer expected price."},"segment":{"description":"Optional simplified sample location used for the featured price estimate.","$ref":"#/$defs/ActionRequestFeaturedPriceEstimateSegment"}},"required":["sku"],"additionalProperties":false},"ActionRequestFeaturedPriceEstimateSegment":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the sample location."},"postalCode":{"type":"string","minLength":1,"maxLength":32,"description":"Postal code for the sample location used in the featured price estimate."}},"required":["countryCode","postalCode"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","label":"Find competitive summary","group":"listings","entity":"Pricing insights","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":60,"mcp":20},"description":"Find the current competitive summary for ASINs, including featured buying options, reference prices, lowest-priced offers, and similar items. Promotions are inside the offer arrays. Supports optional per-ASIN lowest-priced-offer filters.","result":"Full Amazon competitive summary body per ASIN, including nested promotions.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"includedData":{"default":["featuredBuyingOptions","referencePrices","lowestPricedOffers","similarItems"],"description":"Competitive summary data groups to include for every ASIN.","minItems":1,"type":"array","items":{"type":"string","enum":["featuredBuyingOptions","referencePrices","lowestPricedOffers","similarItems"]}},"competitiveSummaries":{"minItems":1,"maxItems":60,"type":"array","items":{"$ref":"#/$defs/ActionRequestCompetitiveSummaryItem"}}},"required":["competitiveSummaries"],"additionalProperties":false,"$defs":{"ActionRequestCompetitiveSummaryItem":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 uppercase alphanumeric characters)."},"lowestPricedOffersInputs":{"description":"Optional lowest-priced offer filters. Requires includedData to contain lowestPricedOffers.","minItems":1,"maxItems":5,"type":"array","items":{"$ref":"#/$defs/ActionRequestCompetitiveSummaryLowestPricedOffersInput"}}},"required":["asin"],"additionalProperties":false},"ActionRequestCompetitiveSummaryLowestPricedOffersInput":{"type":"object","properties":{"itemCondition":{"type":"string","enum":["New","Used","Collectible","Refurbished","Club"],"description":"Item condition filter for lowest-priced offers."},"offerType":{"type":"string","enum":["Consumer"],"description":"Offer type filter for lowest-priced offers."}},"required":["itemCondition","offerType"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_PRODUCT_TYPES_FIND","label":"Find product types","group":"listings","entity":"Product types","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"List available Amazon product types for the Seller or Vendor.","result":"Available product types.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}},{"type":"AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST","label":"Suggest product type","group":"listings","entity":"Product types","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1000,"mcp":100},"description":"Suggest Amazon product types for given product names.","result":"Suggested product types per name.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"productNames":{"minItems":1,"maxItems":1000,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsProductTypeSuggestItem"}}},"required":["productNames"],"additionalProperties":false,"$defs":{"ActionRequestListingsProductTypeSuggestItem":{"type":"object","properties":{"productName":{"type":"string","minLength":1,"maxLength":500,"description":"Product title used to suggest Amazon product types."}},"required":["productName"],"additionalProperties":false}}}},{"type":"AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND","label":"Find product type definition","group":"listings","entity":"Product types","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5,"mcp":1},"description":"Retrieve Amazon product type definition schemas for SKUs or product types. Required to use `AMAZON_LISTINGS_DETAILS_UPDATE` and `AMAZON_LISTINGS_CREATE`.","result":"Product type definition and JSON schema.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vendorCode":{"description":"Amazon vendor code used as Listings Items / Product Type Definitions sellerId. Required only for Vendor Central accounts.","type":"string","minLength":1,"maxLength":32},"definitions":{"minItems":1,"maxItems":5,"type":"array","items":{"$ref":"#/$defs/ActionRequestListingsProductTypeDefinitionItem"}}},"required":["definitions"],"additionalProperties":false,"$defs":{"ActionRequestListingsProductTypeDefinitionItem":{"type":"object","properties":{"identifierType":{"type":"string","enum":["SKU","PRODUCT_TYPE"],"description":"Whether identifier is a listing SKU or an Amazon product type name."},"identifier":{"type":"string","minLength":1,"maxLength":64,"description":"SKU or Amazon product type name."},"productTypeRequirementsSet":{"type":"string","enum":["LISTING","LISTING_PRODUCT_ONLY","LISTING_OFFER_ONLY"],"description":"Amazon product type requirements set to retrieve."}},"required":["identifierType","identifier","productTypeRequirementsSet"],"additionalProperties":false}}}},{"type":"AMAZON_APLUS_CONTENT_ADD","label":"Add A+ content","group":"aplus-content","entity":"A+ content","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Create Amazon A+ Content documents (Standard, Premium, or Brand Story) and optionally associate ASINs.","result":"Created content document reference keys.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"documents":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"contentDocument":{"$ref":"#/$defs/AplusContentDocumentInput"},"asins":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 alphanumeric characters)."}}},"required":["contentDocument"],"additionalProperties":false}}},"required":["documents"],"additionalProperties":false,"$defs":{"AplusContentDocumentInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"contentType":{"type":"string","enum":["EBC","EMC","BrandStory"]},"contentSubType":{"type":"string","minLength":1},"locale":{"type":"string","pattern":"^[a-z]{2,}-[A-Z0-9]{2,}$"},"contentModuleList":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/$defs/AplusContentModuleInput"},"description":"Up to 7 modules for STANDARD_* (5 for vendors) and PREMIUM_* documents. Brand Story documents take a background card plus up to 19 cards."}},"required":["name","contentType","locale","contentModuleList"],"additionalProperties":false,"description":"A+ content document for ADD/UPDATE/VALIDATE. Keep one module family per document: STANDARD_* or PREMIUM_* with contentType EBC (sellers) or EMC (vendors), BRAND_STORY_* with contentType BrandStory and exactly one BRAND_STORY_IMAGE_WITH_LOGO. Do not round-trip FIND output unmodified: strip empty comparison-table columns and reference new images via fileId."},"AplusContentModuleInput":{"description":"Amazon A+ content module: STANDARD_*, PREMIUM_*, or BRAND_STORY_*. Discriminated by contentModuleType with the matching camelCase payload key (for example premiumImageText for PREMIUM_IMAGE_TEXT). Premium list items keep their Amazon wrapper keys (faqs[].faq, carouselCards[].imagePanel, hotSpots[].imageTextHotSpot). For images use fileId (new uploads) or uploadDestinationId (existing aplus-media… paths from FIND). Premium video modules take videoMediaId and imageMediaId registered with AMAZON_APLUS_MEDIA_ADD. FIND responses are not always write-ready — remove empty comparison columns and always include imageCropSpecification. Unknown module types are rejected.","oneOf":[{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPANY_LOGO"},"standardCompanyLogo":{"type":"object","properties":{"companyLogo":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["companyLogo"],"additionalProperties":false}},"required":["contentModuleType","standardCompanyLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPARISON_TABLE"},"standardComparisonTable":{"type":"object","properties":{"productColumns":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"type":"string"},"asin":{"type":"string"},"highlight":{"type":"boolean"},"metrics":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"metricRowLabels":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"required":["contentModuleType","standardComparisonTable"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT"},"standardFourImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT_QUADRANT"},"standardFourImageTextQuadrant":{"type":"object","properties":{"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageTextQuadrant"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_HEADER_IMAGE_TEXT"},"standardHeaderImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block"],"additionalProperties":false}},"required":["contentModuleType","standardHeaderImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_SIDEBAR"},"standardImageSidebar":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"imageCaptionBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["image","caption"],"additionalProperties":false},"descriptionTextBlock":{"$ref":"#/$defs/AplusRequiredTextBlock"},"descriptionListBlock":{"$ref":"#/$defs/AplusTextListBlock"},"sidebarImageTextBlock":{"$ref":"#/$defs/AplusRequiredImageBlock"},"sidebarListBlock":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","imageCaptionBlock","descriptionTextBlock","sidebarImageTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardImageSidebar"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_TEXT_OVERLAY"},"standardImageTextOverlay":{"type":"object","properties":{"overlayColorType":{"type":"string","enum":["DARK","LIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["overlayColorType","block"],"additionalProperties":false}},"required":["contentModuleType","standardImageTextOverlay"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_MULTIPLE_IMAGE_TEXT"},"standardMultipleImageText":{"type":"object","properties":{"blocks":{"minItems":1,"type":"array","items":{"type":"object","properties":{"block":{"$ref":"#/$defs/AplusRequiredImageBlock"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["block"],"additionalProperties":false}}},"required":["blocks"],"additionalProperties":false}},"required":["contentModuleType","standardMultipleImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_PRODUCT_DESCRIPTION"},"standardProductDescription":{"type":"object","properties":{"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["contentModuleType","standardProductDescription"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_HIGHLIGHTS"},"standardSingleImageHighlights":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"textBlock1":{"$ref":"#/$defs/AplusTextBlock"},"textBlock2":{"$ref":"#/$defs/AplusRequiredTextBlock"},"textBlock3":{"$ref":"#/$defs/AplusRequiredTextBlock"},"bulletedListBlock":{"$ref":"#/$defs/AplusRequiredHeaderTextListBlock"}},"required":["image","textBlock2","textBlock3","bulletedListBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageHighlights"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_SPECS_DETAIL"},"standardSingleImageSpecsDetail":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"descriptionHeadline":{"$ref":"#/$defs/AplusPlainText"},"descriptionBlock1":{"$ref":"#/$defs/AplusTextBlock"},"descriptionBlock2":{"$ref":"#/$defs/AplusTextBlock"},"specificationHeadline":{"$ref":"#/$defs/AplusPlainText"},"specificationListBlock":{"$ref":"#/$defs/AplusHeaderTextListBlock"},"specificationTextBlock":{"$ref":"#/$defs/AplusRequiredBodyTextBlock"}},"required":["image","specificationTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageSpecsDetail"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_SIDE_IMAGE"},"standardSingleSideImage":{"type":"object","properties":{"imagePositionType":{"type":"string","enum":["LEFT","RIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["imagePositionType","block"],"additionalProperties":false}},"required":["contentModuleType","standardSingleSideImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TECH_SPECS"},"standardTechSpecs":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"specificationList":{"type":"array","items":{"type":"object","properties":{"label":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["label","description"],"additionalProperties":false}},"tableCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]}},"required":["specificationList"],"additionalProperties":false}},"required":["contentModuleType","standardTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TEXT"},"standardText":{"$ref":"#/$defs/AplusTextBlock"}},"required":["contentModuleType","standardText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_THREE_IMAGE_TEXT"},"standardThreeImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["headline","block1","block2","block3"],"additionalProperties":false}},"required":["contentModuleType","standardThreeImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_TEXT"},"premiumImageText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"bodyText":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","image"],"additionalProperties":false}},"required":["contentModuleType","premiumImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TEXT"},"premiumText":{"type":"object","properties":{"description":{"$ref":"#/$defs/AplusParagraph"},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["description"],"additionalProperties":false}},"required":["contentModuleType","premiumText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_TEXT"},"premiumFullBackgroundText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"colorType":{"type":"string","enum":["DARK","LIGHT"]},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","colorType","desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_IMAGE"},"premiumFullBackgroundImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FOUR_COLUMN_IMAGES"},"premiumFourColumnImages":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":3,"maxItems":4,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumFourColumnImages"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_DUAL_IMAGE_TEXT"},"premiumDualImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumDualImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_CAROUSEL"},"premiumImageCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"},"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imagePanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"buttonText":{"$ref":"#/$defs/AplusPlainText"},"asin":{"$ref":"#/$defs/AplusAsinText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","desktopImage","mobileImage"],"additionalProperties":false}},"required":["imagePanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_NAVIGATION_CAROUSEL"},"premiumNavigationCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"navigationPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"subtitle":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["navigationPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumNavigationCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_REGIMEN_CAROUSEL"},"premiumRegimenCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"regimenPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["regimenPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumRegimenCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_THREE_COLUMN_COMPARISON"},"premiumThreeColumnComparison":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":3},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"comparisonRows":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"metricValues":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"metricName":{"$ref":"#/$defs/AplusPlainText"},"metricValue":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}}},"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumThreeColumnComparison"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_CAROUSEL"},"premiumComparisonCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":5,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonMetrics":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonMetrics"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_SCROLLER"},"premiumComparisonScroller":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false,"description":"Comparison scroller product. This module has no mobileImage."}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonRows":{"minItems":5,"maxItems":12,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":12},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"},"additionalInfo":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}},"showATC":{"type":"boolean"},"showPrices":{"type":"boolean"},"showReviews":{"type":"boolean"}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonScroller"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE"},"premiumHotspotImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageHotSpot"],"additionalProperties":false}}},"required":["desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE_TEXT"},"premiumHotspotImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageTextHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageTextHotSpot"],"additionalProperties":false}},"mainDescription":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FAQ"},"premiumFaq":{"type":"object","properties":{"colorType":{"type":"string","enum":["DARK","LIGHT"]},"faqs":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"faq":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusParagraph"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"required":["question","answer"],"additionalProperties":false}},"required":["faq"],"additionalProperties":false}}},"required":["faqs"],"additionalProperties":false}},"required":["contentModuleType","premiumFaq"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TECH_SPECS"},"premiumTechSpecs":{"type":"object","properties":{"columnCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]},"techSpecs":{"minItems":4,"maxItems":16,"type":"array","items":{"type":"object","properties":{"techSpec":{"type":"object","properties":{"specKey":{"$ref":"#/$defs/AplusPlainText"},"specValue":{"$ref":"#/$defs/AplusPlainText"}},"required":["specKey","specValue"],"additionalProperties":false}},"required":["techSpec"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["techSpecs"],"additionalProperties":false}},"required":["contentModuleType","premiumTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_TEXT"},"premiumVideoText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","video"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HERO_VIDEO"},"premiumHeroVideo":{"type":"object","properties":{"heroVideo":{"$ref":"#/$defs/AplusVideoComponent"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["heroVideo"],"additionalProperties":false}},"required":["contentModuleType","premiumHeroVideo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_IMAGE_CAROUSEL"},"premiumVideoImageCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"videoCarouselPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["position"],"additionalProperties":false}},"required":["videoCarouselPanel"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_IMAGE_WITH_LOGO"},"brandStoryImageWithLogo":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryImageWithLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_FOUR_ASIN"},"brandStoryFourAsin":{"type":"object","properties":{"title":{"$ref":"#/$defs/AplusPlainText"},"asinImages":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"asinImage":{"type":"object","properties":{"productAsin":{"$ref":"#/$defs/AplusAsinText"},"productImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["productAsin","productImage"],"additionalProperties":false}},"required":["asinImage"],"additionalProperties":false}},"brandStoreId":{"$ref":"#/$defs/AplusPlainText"}},"required":["title","asinImages"],"additionalProperties":false}},"required":["contentModuleType","brandStoryFourAsin"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_MEDIA_ASSET"},"brandStoryMediaAsset":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false}},"required":["contentModuleType","brandStoryMediaAsset"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_ABOUT"},"brandStoryAbout":{"type":"object","properties":{"logoImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"slogan":{"$ref":"#/$defs/AplusParagraph"}},"required":["logoImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryAbout"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_QUESTIONS"},"brandStoryQuestions":{"type":"object","properties":{"questionAnswerPairs":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"questionAnswerPair":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusPlainText"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["questionAnswerPair"],"additionalProperties":false}}},"required":["questionAnswerPairs"],"additionalProperties":false}},"required":["contentModuleType","brandStoryQuestions"],"additionalProperties":false}]},"AplusImageComponentInput":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"UUID of an uploaded APLUS_IMAGES DataFile owned by the action seller or vendor. DataDoe uploads this file into Amazon A+ media library and substitutes uploadDestinationId. Do not put this UUID in uploadDestinationId."},"uploadDestinationId":{"type":"string","minLength":1,"description":"Existing Amazon A+ media path from FIND (for example aplus-media-library-service-media/…, aplus-media/sc/…, or /images/I/… catalog images). Never put a DataDoe file UUID here — use fileId instead."},"altText":{"type":"string","minLength":1,"maxLength":100},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Required by Amazon for every A+ image on VALIDATE/UPDATE/ADD, except catalog images (/images/I/…) that FIND returns without a crop. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["altText"],"additionalProperties":false},"AplusIntegerWithUnits":{"type":"object","properties":{"value":{"type":"integer","minimum":0,"maximum":9007199254740991},"units":{"type":"string","minLength":1}},"required":["value","units"],"additionalProperties":false},"AplusPlainTextItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"value":{"type":"string"}},"required":["value"],"additionalProperties":false},"AplusPlainText":{"type":"object","properties":{"value":{"type":"string"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false},"AplusDecorator":{"type":"object","properties":{"type":{"type":"string"},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"length":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":{}},"AplusRequiredImageBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false},"AplusParagraph":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusPlainText"}}},"required":["textList"],"additionalProperties":false},"AplusRequiredImageHeadlineBodyBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image","headline","body"],"additionalProperties":false},"AplusRequiredTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","body"],"additionalProperties":false},"AplusTextListBlock":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusTextListItem"}}},"required":["textList"],"additionalProperties":false},"AplusTextListItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"text":{"$ref":"#/$defs/AplusPlainText"}},"required":["position","text"],"additionalProperties":false},"AplusTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false},"AplusRequiredHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","block"],"additionalProperties":false},"AplusHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"additionalProperties":false},"AplusRequiredBodyTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["body"],"additionalProperties":false},"AplusAsinText":{"type":"object","properties":{"value":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false,"description":"Text component carrying an Amazon ASIN (10 alphanumeric characters)."},"AplusVideoComponent":{"type":"object","properties":{"videoMediaId":{"type":"string","minLength":1,"description":"mediaId of an A+ video asset (AMAZON_APLUS_MEDIA_ADD or FIND output)."},"imageMediaId":{"type":"string","minLength":1,"description":"mediaId of the thumbnail image paired with the video (relatedMedia of the video asset)."},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Crop of the video thumbnail. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["videoMediaId","imageMediaId","imageCropSpecification"],"additionalProperties":false,"description":"Premium video with its paired thumbnail. Register the pairing with AMAZON_APLUS_MEDIA_ADD before referencing it."}}}},{"type":"AMAZON_APLUS_CONTENT_UPDATE","label":"Update A+ content","group":"aplus-content","entity":"A+ content","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Update an existing Amazon A+ Content document.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"documents":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"contentReferenceKey":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."},"contentDocument":{"$ref":"#/$defs/AplusContentDocumentInput"}},"required":["contentReferenceKey","contentDocument"],"additionalProperties":false}}},"required":["documents"],"additionalProperties":false,"$defs":{"AplusContentDocumentInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"contentType":{"type":"string","enum":["EBC","EMC","BrandStory"]},"contentSubType":{"type":"string","minLength":1},"locale":{"type":"string","pattern":"^[a-z]{2,}-[A-Z0-9]{2,}$"},"contentModuleList":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/$defs/AplusContentModuleInput"},"description":"Up to 7 modules for STANDARD_* (5 for vendors) and PREMIUM_* documents. Brand Story documents take a background card plus up to 19 cards."}},"required":["name","contentType","locale","contentModuleList"],"additionalProperties":false,"description":"A+ content document for ADD/UPDATE/VALIDATE. Keep one module family per document: STANDARD_* or PREMIUM_* with contentType EBC (sellers) or EMC (vendors), BRAND_STORY_* with contentType BrandStory and exactly one BRAND_STORY_IMAGE_WITH_LOGO. Do not round-trip FIND output unmodified: strip empty comparison-table columns and reference new images via fileId."},"AplusContentModuleInput":{"description":"Amazon A+ content module: STANDARD_*, PREMIUM_*, or BRAND_STORY_*. Discriminated by contentModuleType with the matching camelCase payload key (for example premiumImageText for PREMIUM_IMAGE_TEXT). Premium list items keep their Amazon wrapper keys (faqs[].faq, carouselCards[].imagePanel, hotSpots[].imageTextHotSpot). For images use fileId (new uploads) or uploadDestinationId (existing aplus-media… paths from FIND). Premium video modules take videoMediaId and imageMediaId registered with AMAZON_APLUS_MEDIA_ADD. FIND responses are not always write-ready — remove empty comparison columns and always include imageCropSpecification. Unknown module types are rejected.","oneOf":[{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPANY_LOGO"},"standardCompanyLogo":{"type":"object","properties":{"companyLogo":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["companyLogo"],"additionalProperties":false}},"required":["contentModuleType","standardCompanyLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPARISON_TABLE"},"standardComparisonTable":{"type":"object","properties":{"productColumns":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"type":"string"},"asin":{"type":"string"},"highlight":{"type":"boolean"},"metrics":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"metricRowLabels":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"required":["contentModuleType","standardComparisonTable"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT"},"standardFourImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT_QUADRANT"},"standardFourImageTextQuadrant":{"type":"object","properties":{"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageTextQuadrant"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_HEADER_IMAGE_TEXT"},"standardHeaderImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block"],"additionalProperties":false}},"required":["contentModuleType","standardHeaderImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_SIDEBAR"},"standardImageSidebar":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"imageCaptionBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["image","caption"],"additionalProperties":false},"descriptionTextBlock":{"$ref":"#/$defs/AplusRequiredTextBlock"},"descriptionListBlock":{"$ref":"#/$defs/AplusTextListBlock"},"sidebarImageTextBlock":{"$ref":"#/$defs/AplusRequiredImageBlock"},"sidebarListBlock":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","imageCaptionBlock","descriptionTextBlock","sidebarImageTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardImageSidebar"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_TEXT_OVERLAY"},"standardImageTextOverlay":{"type":"object","properties":{"overlayColorType":{"type":"string","enum":["DARK","LIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["overlayColorType","block"],"additionalProperties":false}},"required":["contentModuleType","standardImageTextOverlay"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_MULTIPLE_IMAGE_TEXT"},"standardMultipleImageText":{"type":"object","properties":{"blocks":{"minItems":1,"type":"array","items":{"type":"object","properties":{"block":{"$ref":"#/$defs/AplusRequiredImageBlock"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["block"],"additionalProperties":false}}},"required":["blocks"],"additionalProperties":false}},"required":["contentModuleType","standardMultipleImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_PRODUCT_DESCRIPTION"},"standardProductDescription":{"type":"object","properties":{"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["contentModuleType","standardProductDescription"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_HIGHLIGHTS"},"standardSingleImageHighlights":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"textBlock1":{"$ref":"#/$defs/AplusTextBlock"},"textBlock2":{"$ref":"#/$defs/AplusRequiredTextBlock"},"textBlock3":{"$ref":"#/$defs/AplusRequiredTextBlock"},"bulletedListBlock":{"$ref":"#/$defs/AplusRequiredHeaderTextListBlock"}},"required":["image","textBlock2","textBlock3","bulletedListBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageHighlights"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_SPECS_DETAIL"},"standardSingleImageSpecsDetail":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"descriptionHeadline":{"$ref":"#/$defs/AplusPlainText"},"descriptionBlock1":{"$ref":"#/$defs/AplusTextBlock"},"descriptionBlock2":{"$ref":"#/$defs/AplusTextBlock"},"specificationHeadline":{"$ref":"#/$defs/AplusPlainText"},"specificationListBlock":{"$ref":"#/$defs/AplusHeaderTextListBlock"},"specificationTextBlock":{"$ref":"#/$defs/AplusRequiredBodyTextBlock"}},"required":["image","specificationTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageSpecsDetail"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_SIDE_IMAGE"},"standardSingleSideImage":{"type":"object","properties":{"imagePositionType":{"type":"string","enum":["LEFT","RIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["imagePositionType","block"],"additionalProperties":false}},"required":["contentModuleType","standardSingleSideImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TECH_SPECS"},"standardTechSpecs":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"specificationList":{"type":"array","items":{"type":"object","properties":{"label":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["label","description"],"additionalProperties":false}},"tableCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]}},"required":["specificationList"],"additionalProperties":false}},"required":["contentModuleType","standardTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TEXT"},"standardText":{"$ref":"#/$defs/AplusTextBlock"}},"required":["contentModuleType","standardText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_THREE_IMAGE_TEXT"},"standardThreeImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["headline","block1","block2","block3"],"additionalProperties":false}},"required":["contentModuleType","standardThreeImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_TEXT"},"premiumImageText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"bodyText":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","image"],"additionalProperties":false}},"required":["contentModuleType","premiumImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TEXT"},"premiumText":{"type":"object","properties":{"description":{"$ref":"#/$defs/AplusParagraph"},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["description"],"additionalProperties":false}},"required":["contentModuleType","premiumText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_TEXT"},"premiumFullBackgroundText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"colorType":{"type":"string","enum":["DARK","LIGHT"]},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","colorType","desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_IMAGE"},"premiumFullBackgroundImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FOUR_COLUMN_IMAGES"},"premiumFourColumnImages":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":3,"maxItems":4,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumFourColumnImages"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_DUAL_IMAGE_TEXT"},"premiumDualImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumDualImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_CAROUSEL"},"premiumImageCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"},"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imagePanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"buttonText":{"$ref":"#/$defs/AplusPlainText"},"asin":{"$ref":"#/$defs/AplusAsinText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","desktopImage","mobileImage"],"additionalProperties":false}},"required":["imagePanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_NAVIGATION_CAROUSEL"},"premiumNavigationCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"navigationPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"subtitle":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["navigationPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumNavigationCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_REGIMEN_CAROUSEL"},"premiumRegimenCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"regimenPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["regimenPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumRegimenCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_THREE_COLUMN_COMPARISON"},"premiumThreeColumnComparison":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":3},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"comparisonRows":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"metricValues":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"metricName":{"$ref":"#/$defs/AplusPlainText"},"metricValue":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}}},"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumThreeColumnComparison"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_CAROUSEL"},"premiumComparisonCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":5,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonMetrics":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonMetrics"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_SCROLLER"},"premiumComparisonScroller":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false,"description":"Comparison scroller product. This module has no mobileImage."}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonRows":{"minItems":5,"maxItems":12,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":12},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"},"additionalInfo":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}},"showATC":{"type":"boolean"},"showPrices":{"type":"boolean"},"showReviews":{"type":"boolean"}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonScroller"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE"},"premiumHotspotImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageHotSpot"],"additionalProperties":false}}},"required":["desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE_TEXT"},"premiumHotspotImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageTextHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageTextHotSpot"],"additionalProperties":false}},"mainDescription":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FAQ"},"premiumFaq":{"type":"object","properties":{"colorType":{"type":"string","enum":["DARK","LIGHT"]},"faqs":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"faq":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusParagraph"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"required":["question","answer"],"additionalProperties":false}},"required":["faq"],"additionalProperties":false}}},"required":["faqs"],"additionalProperties":false}},"required":["contentModuleType","premiumFaq"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TECH_SPECS"},"premiumTechSpecs":{"type":"object","properties":{"columnCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]},"techSpecs":{"minItems":4,"maxItems":16,"type":"array","items":{"type":"object","properties":{"techSpec":{"type":"object","properties":{"specKey":{"$ref":"#/$defs/AplusPlainText"},"specValue":{"$ref":"#/$defs/AplusPlainText"}},"required":["specKey","specValue"],"additionalProperties":false}},"required":["techSpec"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["techSpecs"],"additionalProperties":false}},"required":["contentModuleType","premiumTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_TEXT"},"premiumVideoText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","video"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HERO_VIDEO"},"premiumHeroVideo":{"type":"object","properties":{"heroVideo":{"$ref":"#/$defs/AplusVideoComponent"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["heroVideo"],"additionalProperties":false}},"required":["contentModuleType","premiumHeroVideo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_IMAGE_CAROUSEL"},"premiumVideoImageCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"videoCarouselPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["position"],"additionalProperties":false}},"required":["videoCarouselPanel"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_IMAGE_WITH_LOGO"},"brandStoryImageWithLogo":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryImageWithLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_FOUR_ASIN"},"brandStoryFourAsin":{"type":"object","properties":{"title":{"$ref":"#/$defs/AplusPlainText"},"asinImages":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"asinImage":{"type":"object","properties":{"productAsin":{"$ref":"#/$defs/AplusAsinText"},"productImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["productAsin","productImage"],"additionalProperties":false}},"required":["asinImage"],"additionalProperties":false}},"brandStoreId":{"$ref":"#/$defs/AplusPlainText"}},"required":["title","asinImages"],"additionalProperties":false}},"required":["contentModuleType","brandStoryFourAsin"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_MEDIA_ASSET"},"brandStoryMediaAsset":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false}},"required":["contentModuleType","brandStoryMediaAsset"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_ABOUT"},"brandStoryAbout":{"type":"object","properties":{"logoImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"slogan":{"$ref":"#/$defs/AplusParagraph"}},"required":["logoImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryAbout"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_QUESTIONS"},"brandStoryQuestions":{"type":"object","properties":{"questionAnswerPairs":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"questionAnswerPair":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusPlainText"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["questionAnswerPair"],"additionalProperties":false}}},"required":["questionAnswerPairs"],"additionalProperties":false}},"required":["contentModuleType","brandStoryQuestions"],"additionalProperties":false}]},"AplusImageComponentInput":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"UUID of an uploaded APLUS_IMAGES DataFile owned by the action seller or vendor. DataDoe uploads this file into Amazon A+ media library and substitutes uploadDestinationId. Do not put this UUID in uploadDestinationId."},"uploadDestinationId":{"type":"string","minLength":1,"description":"Existing Amazon A+ media path from FIND (for example aplus-media-library-service-media/…, aplus-media/sc/…, or /images/I/… catalog images). Never put a DataDoe file UUID here — use fileId instead."},"altText":{"type":"string","minLength":1,"maxLength":100},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Required by Amazon for every A+ image on VALIDATE/UPDATE/ADD, except catalog images (/images/I/…) that FIND returns without a crop. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["altText"],"additionalProperties":false},"AplusIntegerWithUnits":{"type":"object","properties":{"value":{"type":"integer","minimum":0,"maximum":9007199254740991},"units":{"type":"string","minLength":1}},"required":["value","units"],"additionalProperties":false},"AplusPlainTextItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"value":{"type":"string"}},"required":["value"],"additionalProperties":false},"AplusPlainText":{"type":"object","properties":{"value":{"type":"string"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false},"AplusDecorator":{"type":"object","properties":{"type":{"type":"string"},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"length":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":{}},"AplusRequiredImageBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false},"AplusParagraph":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusPlainText"}}},"required":["textList"],"additionalProperties":false},"AplusRequiredImageHeadlineBodyBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image","headline","body"],"additionalProperties":false},"AplusRequiredTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","body"],"additionalProperties":false},"AplusTextListBlock":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusTextListItem"}}},"required":["textList"],"additionalProperties":false},"AplusTextListItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"text":{"$ref":"#/$defs/AplusPlainText"}},"required":["position","text"],"additionalProperties":false},"AplusTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false},"AplusRequiredHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","block"],"additionalProperties":false},"AplusHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"additionalProperties":false},"AplusRequiredBodyTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["body"],"additionalProperties":false},"AplusAsinText":{"type":"object","properties":{"value":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false,"description":"Text component carrying an Amazon ASIN (10 alphanumeric characters)."},"AplusVideoComponent":{"type":"object","properties":{"videoMediaId":{"type":"string","minLength":1,"description":"mediaId of an A+ video asset (AMAZON_APLUS_MEDIA_ADD or FIND output)."},"imageMediaId":{"type":"string","minLength":1,"description":"mediaId of the thumbnail image paired with the video (relatedMedia of the video asset)."},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Crop of the video thumbnail. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["videoMediaId","imageMediaId","imageCropSpecification"],"additionalProperties":false,"description":"Premium video with its paired thumbnail. Register the pairing with AMAZON_APLUS_MEDIA_ADD before referencing it."}}}},{"type":"AMAZON_APLUS_CONTENT_FIND","label":"Find A+ content","group":"aplus-content","entity":"A+ content","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":20},"description":"Search or retrieve Amazon A+ Content documents by content reference key.","result":"Content documents and metadata.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"contentReferenceKeys":{"description":"Specific content documents to retrieve. When omitted, searches all documents for the marketplace.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."}},"includedData":{"default":["METADATA","CONTENTS"],"minItems":1,"type":"array","items":{"type":"string","enum":["METADATA","CONTENTS"]}}},"additionalProperties":false}},{"type":"AMAZON_APLUS_CONTENT_ASINS_UPDATE","label":"Update A+ content ASINs","group":"aplus-content","entity":"ASIN links","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Associate or update ASIN relations for an A+ Content document.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"contentReferenceKey":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."},"asins":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 alphanumeric characters)."}}},"required":["contentReferenceKey","asins"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},{"type":"AMAZON_APLUS_CONTENT_ASINS_FIND","label":"Find A+ content ASINs","group":"aplus-content","entity":"ASIN links","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":25},"description":"List ASIN relations for A+ Content documents.","result":"ASIN relations per document.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"contentReferenceKey":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."}},"required":["contentReferenceKey"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},{"type":"AMAZON_APLUS_CONTENT_VALIDATE","label":"Validate A+ content","group":"aplus-content","entity":"Publishing","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Validate A+ Content documents and ASIN relations before publishing.","result":"Validation results per document.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"contentDocument":{"$ref":"#/$defs/AplusContentDocumentInput"},"asins":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 alphanumeric characters)."}}},"required":["contentDocument"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false,"$defs":{"AplusContentDocumentInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"contentType":{"type":"string","enum":["EBC","EMC","BrandStory"]},"contentSubType":{"type":"string","minLength":1},"locale":{"type":"string","pattern":"^[a-z]{2,}-[A-Z0-9]{2,}$"},"contentModuleList":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/$defs/AplusContentModuleInput"},"description":"Up to 7 modules for STANDARD_* (5 for vendors) and PREMIUM_* documents. Brand Story documents take a background card plus up to 19 cards."}},"required":["name","contentType","locale","contentModuleList"],"additionalProperties":false,"description":"A+ content document for ADD/UPDATE/VALIDATE. Keep one module family per document: STANDARD_* or PREMIUM_* with contentType EBC (sellers) or EMC (vendors), BRAND_STORY_* with contentType BrandStory and exactly one BRAND_STORY_IMAGE_WITH_LOGO. Do not round-trip FIND output unmodified: strip empty comparison-table columns and reference new images via fileId."},"AplusContentModuleInput":{"description":"Amazon A+ content module: STANDARD_*, PREMIUM_*, or BRAND_STORY_*. Discriminated by contentModuleType with the matching camelCase payload key (for example premiumImageText for PREMIUM_IMAGE_TEXT). Premium list items keep their Amazon wrapper keys (faqs[].faq, carouselCards[].imagePanel, hotSpots[].imageTextHotSpot). For images use fileId (new uploads) or uploadDestinationId (existing aplus-media… paths from FIND). Premium video modules take videoMediaId and imageMediaId registered with AMAZON_APLUS_MEDIA_ADD. FIND responses are not always write-ready — remove empty comparison columns and always include imageCropSpecification. Unknown module types are rejected.","oneOf":[{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPANY_LOGO"},"standardCompanyLogo":{"type":"object","properties":{"companyLogo":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["companyLogo"],"additionalProperties":false}},"required":["contentModuleType","standardCompanyLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_COMPARISON_TABLE"},"standardComparisonTable":{"type":"object","properties":{"productColumns":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"type":"string"},"asin":{"type":"string"},"highlight":{"type":"boolean"},"metrics":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"metricRowLabels":{"type":"array","items":{"$ref":"#/$defs/AplusPlainTextItem"}}},"additionalProperties":false}},"required":["contentModuleType","standardComparisonTable"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT"},"standardFourImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_FOUR_IMAGE_TEXT_QUADRANT"},"standardFourImageTextQuadrant":{"type":"object","properties":{"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block4":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["block1","block2","block3","block4"],"additionalProperties":false}},"required":["contentModuleType","standardFourImageTextQuadrant"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_HEADER_IMAGE_TEXT"},"standardHeaderImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["block"],"additionalProperties":false}},"required":["contentModuleType","standardHeaderImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_SIDEBAR"},"standardImageSidebar":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"imageCaptionBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["image","caption"],"additionalProperties":false},"descriptionTextBlock":{"$ref":"#/$defs/AplusRequiredTextBlock"},"descriptionListBlock":{"$ref":"#/$defs/AplusTextListBlock"},"sidebarImageTextBlock":{"$ref":"#/$defs/AplusRequiredImageBlock"},"sidebarListBlock":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","imageCaptionBlock","descriptionTextBlock","sidebarImageTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardImageSidebar"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_IMAGE_TEXT_OVERLAY"},"standardImageTextOverlay":{"type":"object","properties":{"overlayColorType":{"type":"string","enum":["DARK","LIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["overlayColorType","block"],"additionalProperties":false}},"required":["contentModuleType","standardImageTextOverlay"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_MULTIPLE_IMAGE_TEXT"},"standardMultipleImageText":{"type":"object","properties":{"blocks":{"minItems":1,"type":"array","items":{"type":"object","properties":{"block":{"$ref":"#/$defs/AplusRequiredImageBlock"},"caption":{"$ref":"#/$defs/AplusPlainText"}},"required":["block"],"additionalProperties":false}}},"required":["blocks"],"additionalProperties":false}},"required":["contentModuleType","standardMultipleImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_PRODUCT_DESCRIPTION"},"standardProductDescription":{"type":"object","properties":{"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["contentModuleType","standardProductDescription"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_HIGHLIGHTS"},"standardSingleImageHighlights":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"textBlock1":{"$ref":"#/$defs/AplusTextBlock"},"textBlock2":{"$ref":"#/$defs/AplusRequiredTextBlock"},"textBlock3":{"$ref":"#/$defs/AplusRequiredTextBlock"},"bulletedListBlock":{"$ref":"#/$defs/AplusRequiredHeaderTextListBlock"}},"required":["image","textBlock2","textBlock3","bulletedListBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageHighlights"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_IMAGE_SPECS_DETAIL"},"standardSingleImageSpecsDetail":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"descriptionHeadline":{"$ref":"#/$defs/AplusPlainText"},"descriptionBlock1":{"$ref":"#/$defs/AplusTextBlock"},"descriptionBlock2":{"$ref":"#/$defs/AplusTextBlock"},"specificationHeadline":{"$ref":"#/$defs/AplusPlainText"},"specificationListBlock":{"$ref":"#/$defs/AplusHeaderTextListBlock"},"specificationTextBlock":{"$ref":"#/$defs/AplusRequiredBodyTextBlock"}},"required":["image","specificationTextBlock"],"additionalProperties":false}},"required":["contentModuleType","standardSingleImageSpecsDetail"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_SINGLE_SIDE_IMAGE"},"standardSingleSideImage":{"type":"object","properties":{"imagePositionType":{"type":"string","enum":["LEFT","RIGHT"]},"block":{"$ref":"#/$defs/AplusRequiredImageBlock"}},"required":["imagePositionType","block"],"additionalProperties":false}},"required":["contentModuleType","standardSingleSideImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TECH_SPECS"},"standardTechSpecs":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"specificationList":{"type":"array","items":{"type":"object","properties":{"label":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["label","description"],"additionalProperties":false}},"tableCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]}},"required":["specificationList"],"additionalProperties":false}},"required":["contentModuleType","standardTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_TEXT"},"standardText":{"$ref":"#/$defs/AplusTextBlock"}},"required":["contentModuleType","standardText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"STANDARD_THREE_IMAGE_TEXT"},"standardThreeImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block1":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block2":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"},"block3":{"$ref":"#/$defs/AplusRequiredImageHeadlineBodyBlock"}},"required":["headline","block1","block2","block3"],"additionalProperties":false}},"required":["contentModuleType","standardThreeImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_TEXT"},"premiumImageText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"bodyText":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","image"],"additionalProperties":false}},"required":["contentModuleType","premiumImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TEXT"},"premiumText":{"type":"object","properties":{"description":{"$ref":"#/$defs/AplusParagraph"},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["description"],"additionalProperties":false}},"required":["contentModuleType","premiumText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_TEXT"},"premiumFullBackgroundText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"colorType":{"type":"string","enum":["DARK","LIGHT"]},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","colorType","desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FULL_BACKGROUND_IMAGE"},"premiumFullBackgroundImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","premiumFullBackgroundImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FOUR_COLUMN_IMAGES"},"premiumFourColumnImages":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":3,"maxItems":4,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumFourColumnImages"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_DUAL_IMAGE_TEXT"},"premiumDualImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"columns":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"object","properties":{"imageColumn":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","image"],"additionalProperties":false}},"required":["imageColumn"],"additionalProperties":false}}},"required":["columns"],"additionalProperties":false}},"required":["contentModuleType","premiumDualImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_IMAGE_CAROUSEL"},"premiumImageCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"},"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imagePanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"buttonText":{"$ref":"#/$defs/AplusPlainText"},"asin":{"$ref":"#/$defs/AplusAsinText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","desktopImage","mobileImage"],"additionalProperties":false}},"required":["imagePanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_NAVIGATION_CAROUSEL"},"premiumNavigationCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"navigationPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"subtitle":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["navigationPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumNavigationCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_REGIMEN_CAROUSEL"},"premiumRegimenCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"carouselCards":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"regimenPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"navText":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["position","navText","desktopImage","mobileImage"],"additionalProperties":false}},"required":["regimenPanel"],"additionalProperties":false}}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumRegimenCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_THREE_COLUMN_COMPARISON"},"premiumThreeColumnComparison":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":3},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"image":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"comparisonRows":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"metricValues":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"metricName":{"$ref":"#/$defs/AplusPlainText"},"metricValue":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}}},"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumThreeColumnComparison"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_CAROUSEL"},"premiumComparisonCarousel":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":5,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":5},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonMetrics":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}}},"required":["headline","comparisonProducts","comparisonMetrics"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_COMPARISON_SCROLLER"},"premiumComparisonScroller":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"comparisonProducts":{"minItems":3,"maxItems":7,"type":"array","items":{"type":"object","properties":{"comparisonProduct":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":7},"productTitle":{"$ref":"#/$defs/AplusPlainText"},"productAsin":{"$ref":"#/$defs/AplusAsinText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"additionalProperties":false,"description":"Comparison scroller product. This module has no mobileImage."}},"required":["comparisonProduct"],"additionalProperties":false}},"comparisonRows":{"minItems":5,"maxItems":12,"type":"array","items":{"type":"object","properties":{"comparisonRow":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":12},"comparisonType":{"description":"Render style: \"checkbox\" for true/false cells, \"input-field\" for text cells.","$ref":"#/$defs/AplusPlainText"},"comparisonFields":{"type":"array","items":{"type":"object","properties":{"comparisonField":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":9007199254740991},"value":{"type":"string","minLength":1}},"required":["position"],"additionalProperties":false}},"required":["comparisonField"],"additionalProperties":false}},"metricName":{"$ref":"#/$defs/AplusPlainText"},"additionalInfo":{"$ref":"#/$defs/AplusPlainText"}},"additionalProperties":false}},"required":["comparisonRow"],"additionalProperties":false}},"showATC":{"type":"boolean"},"showPrices":{"type":"boolean"},"showReviews":{"type":"boolean"}},"required":["headline","comparisonProducts","comparisonRows"],"additionalProperties":false}},"required":["contentModuleType","premiumComparisonScroller"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE"},"premiumHotspotImage":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageHotSpot"],"additionalProperties":false}}},"required":["desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImage"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HOTSPOT_IMAGE_TEXT"},"premiumHotspotImageText":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"hotSpots":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"imageTextHotSpot":{"type":"object","properties":{"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"xCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"},"yCoordinate":{"description":"Pixel offset on the 1464 x 600 desktop image as a string (for example \"150\"). Keep x between 23 and 1441, y between 23 and 577, and markers at least 95 px apart.","$ref":"#/$defs/AplusPlainText"}},"required":["mobileImage","title","xCoordinate","yCoordinate"],"additionalProperties":false}},"required":["imageTextHotSpot"],"additionalProperties":false}},"mainDescription":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","desktopImage","hotSpots"],"additionalProperties":false}},"required":["contentModuleType","premiumHotspotImageText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_FAQ"},"premiumFaq":{"type":"object","properties":{"colorType":{"type":"string","enum":["DARK","LIGHT"]},"faqs":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"object","properties":{"faq":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusParagraph"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"required":["question","answer"],"additionalProperties":false}},"required":["faq"],"additionalProperties":false}}},"required":["faqs"],"additionalProperties":false}},"required":["contentModuleType","premiumFaq"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_TECH_SPECS"},"premiumTechSpecs":{"type":"object","properties":{"columnCount":{"anyOf":[{"type":"number","const":1},{"type":"number","const":2}]},"techSpecs":{"minItems":4,"maxItems":16,"type":"array","items":{"type":"object","properties":{"techSpec":{"type":"object","properties":{"specKey":{"$ref":"#/$defs/AplusPlainText"},"specValue":{"$ref":"#/$defs/AplusPlainText"}},"required":["specKey","specValue"],"additionalProperties":false}},"required":["techSpec"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["techSpecs"],"additionalProperties":false}},"required":["contentModuleType","premiumTechSpecs"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_TEXT"},"premiumVideoText":{"type":"object","properties":{"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"headline":{"$ref":"#/$defs/AplusPlainText"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["positionType","headline","video"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoText"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_HERO_VIDEO"},"premiumHeroVideo":{"type":"object","properties":{"heroVideo":{"$ref":"#/$defs/AplusVideoComponent"},"headline":{"$ref":"#/$defs/AplusPlainText"},"footer":{"$ref":"#/$defs/AplusParagraph"}},"required":["heroVideo"],"additionalProperties":false}},"required":["contentModuleType","premiumHeroVideo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"PREMIUM_VIDEO_IMAGE_CAROUSEL"},"premiumVideoImageCarousel":{"type":"object","properties":{"carouselCards":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"object","properties":{"videoCarouselPanel":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":6},"positionType":{"type":"string","enum":["LEFT","RIGHT"]},"subheadline":{"$ref":"#/$defs/AplusPlainText"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"},"video":{"$ref":"#/$defs/AplusVideoComponent"},"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["position"],"additionalProperties":false}},"required":["videoCarouselPanel"],"additionalProperties":false}},"headline":{"$ref":"#/$defs/AplusPlainText"}},"required":["carouselCards"],"additionalProperties":false}},"required":["contentModuleType","premiumVideoImageCarousel"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_IMAGE_WITH_LOGO"},"brandStoryImageWithLogo":{"type":"object","properties":{"desktopImage":{"$ref":"#/$defs/AplusImageComponentInput"},"mobileImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["desktopImage","mobileImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryImageWithLogo"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_FOUR_ASIN"},"brandStoryFourAsin":{"type":"object","properties":{"title":{"$ref":"#/$defs/AplusPlainText"},"asinImages":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"asinImage":{"type":"object","properties":{"productAsin":{"$ref":"#/$defs/AplusAsinText"},"productImage":{"$ref":"#/$defs/AplusImageComponentInput"}},"required":["productAsin","productImage"],"additionalProperties":false}},"required":["asinImage"],"additionalProperties":false}},"brandStoreId":{"$ref":"#/$defs/AplusPlainText"}},"required":["title","asinImages"],"additionalProperties":false}},"required":["contentModuleType","brandStoryFourAsin"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_MEDIA_ASSET"},"brandStoryMediaAsset":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"description":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false}},"required":["contentModuleType","brandStoryMediaAsset"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_ABOUT"},"brandStoryAbout":{"type":"object","properties":{"logoImage":{"$ref":"#/$defs/AplusImageComponentInput"},"title":{"$ref":"#/$defs/AplusPlainText"},"slogan":{"$ref":"#/$defs/AplusParagraph"}},"required":["logoImage"],"additionalProperties":false}},"required":["contentModuleType","brandStoryAbout"],"additionalProperties":false},{"type":"object","properties":{"contentModuleType":{"type":"string","const":"BRAND_STORY_QUESTIONS"},"brandStoryQuestions":{"type":"object","properties":{"questionAnswerPairs":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"object","properties":{"questionAnswerPair":{"type":"object","properties":{"question":{"$ref":"#/$defs/AplusPlainText"},"answer":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false}},"required":["questionAnswerPair"],"additionalProperties":false}}},"required":["questionAnswerPairs"],"additionalProperties":false}},"required":["contentModuleType","brandStoryQuestions"],"additionalProperties":false}]},"AplusImageComponentInput":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"UUID of an uploaded APLUS_IMAGES DataFile owned by the action seller or vendor. DataDoe uploads this file into Amazon A+ media library and substitutes uploadDestinationId. Do not put this UUID in uploadDestinationId."},"uploadDestinationId":{"type":"string","minLength":1,"description":"Existing Amazon A+ media path from FIND (for example aplus-media-library-service-media/…, aplus-media/sc/…, or /images/I/… catalog images). Never put a DataDoe file UUID here — use fileId instead."},"altText":{"type":"string","minLength":1,"maxLength":100},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Required by Amazon for every A+ image on VALIDATE/UPDATE/ADD, except catalog images (/images/I/…) that FIND returns without a crop. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["altText"],"additionalProperties":false},"AplusIntegerWithUnits":{"type":"object","properties":{"value":{"type":"integer","minimum":0,"maximum":9007199254740991},"units":{"type":"string","minLength":1}},"required":["value","units"],"additionalProperties":false},"AplusPlainTextItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"value":{"type":"string"}},"required":["value"],"additionalProperties":false},"AplusPlainText":{"type":"object","properties":{"value":{"type":"string"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false},"AplusDecorator":{"type":"object","properties":{"type":{"type":"string"},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"length":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":{}},"AplusRequiredImageBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image"],"additionalProperties":false},"AplusParagraph":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusPlainText"}}},"required":["textList"],"additionalProperties":false},"AplusRequiredImageHeadlineBodyBlock":{"type":"object","properties":{"image":{"$ref":"#/$defs/AplusImageComponentInput"},"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["image","headline","body"],"additionalProperties":false},"AplusRequiredTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["headline","body"],"additionalProperties":false},"AplusTextListBlock":{"type":"object","properties":{"textList":{"type":"array","items":{"$ref":"#/$defs/AplusTextListItem"}}},"required":["textList"],"additionalProperties":false},"AplusTextListItem":{"type":"object","properties":{"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"text":{"$ref":"#/$defs/AplusPlainText"}},"required":["position","text"],"additionalProperties":false},"AplusTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"additionalProperties":false},"AplusRequiredHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"required":["headline","block"],"additionalProperties":false},"AplusHeaderTextListBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"block":{"$ref":"#/$defs/AplusTextListBlock"}},"additionalProperties":false},"AplusRequiredBodyTextBlock":{"type":"object","properties":{"headline":{"$ref":"#/$defs/AplusPlainText"},"body":{"$ref":"#/$defs/AplusParagraph"}},"required":["body"],"additionalProperties":false},"AplusAsinText":{"type":"object","properties":{"value":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"decoratorSet":{"type":"array","items":{"$ref":"#/$defs/AplusDecorator"}}},"required":["value"],"additionalProperties":false,"description":"Text component carrying an Amazon ASIN (10 alphanumeric characters)."},"AplusVideoComponent":{"type":"object","properties":{"videoMediaId":{"type":"string","minLength":1,"description":"mediaId of an A+ video asset (AMAZON_APLUS_MEDIA_ADD or FIND output)."},"imageMediaId":{"type":"string","minLength":1,"description":"mediaId of the thumbnail image paired with the video (relatedMedia of the video asset)."},"imageCropSpecification":{"type":"object","properties":{"size":{"type":"object","properties":{"width":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"height":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["width","height"],"additionalProperties":false},"offset":{"type":"object","properties":{"x":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]},"y":{"description":"Crop measure: a pixel integer or { value, units }. Bare numbers become { value, units: \"pixels\" }. Object units stay as provided (no px/PX aliases).","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Pixel integer. Coerced to { value, units: \"pixels\" } on intake."},{"$ref":"#/$defs/AplusIntegerWithUnits"}]}},"required":["x","y"],"additionalProperties":false}},"required":["size"],"additionalProperties":false,"description":"Crop of the video thumbnail. Accepts IntegerWithUnits or a bare pixel integer per dimension."}},"required":["videoMediaId","imageMediaId","imageCropSpecification"],"additionalProperties":false,"description":"Premium video with its paired thumbnail. Register the pairing with AMAZON_APLUS_MEDIA_ADD before referencing it."}}}},{"type":"AMAZON_APLUS_CONTENT_PUBLISH","label":"Publish A+ content","group":"aplus-content","entity":"Publishing","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":25},"description":"Submit an A+ Content document for Amazon approval.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"contentReferenceKeys":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."}}},"required":["contentReferenceKeys"],"additionalProperties":false}},{"type":"AMAZON_APLUS_CONTENT_SUSPEND","label":"Suspend A+ content","group":"aplus-content","entity":"Publishing","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":25},"description":"Suspend a published A+ Content document.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"contentReferenceKeys":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":100,"description":"A+ content document reference key returned by Amazon."}}},"required":["contentReferenceKeys"],"additionalProperties":false}},{"type":"AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND","label":"Find A+ publish records","group":"aplus-content","entity":"Publishing","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":100,"mcp":50},"description":"Search A+ Content publish records by ASIN.","result":"Publish records per ASIN.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asins":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 alphanumeric characters)."}}},"required":["asins"],"additionalProperties":false}},{"type":"AMAZON_APLUS_MEDIA_ADD","label":"Add A+ media","group":"aplus-content","entity":"A+ media","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Register A+ media assets: images, and video thumbnail pairings for Premium video modules.","result":"Media IDs, status, and related media per asset.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/$defs/AmazonAplusMediaAddItem"}}},"required":["items"],"additionalProperties":false,"$defs":{"AmazonAplusMediaAddItem":{"oneOf":[{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"UUID of an uploaded APLUS_IMAGES DataFile owned by the action seller or vendor. DataDoe uploads it to Amazon and registers the resulting uploadDestinationId."},"uploadDestinationId":{"type":"string","minLength":1,"description":"Existing Amazon A+ media path from AMAZON_APLUS_CONTENT_FIND (for example aplus-media-library-service-media/…, aplus-media/sc/…, or /images/I/… catalog images)."},"mediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Amazon A+ media asset identifier (mediaId) returned by AMAZON_APLUS_MEDIA_ADD."},"title":{"type":"string","minLength":1}},"required":["mediaType"],"additionalProperties":false},{"type":"object","properties":{"mediaType":{"type":"string","const":"VIDEO"},"mediaId":{"type":"string","minLength":1,"maxLength":100,"description":"mediaId of an existing A+ video asset, for example videoMediaId from AMAZON_APLUS_CONTENT_FIND. DataDoe does not upload video files."},"relatedMedia":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"associationType":{"default":"VIDEO_PAIRING","type":"string","const":"VIDEO_PAIRING"},"title":{"type":"string","minLength":1,"description":"Descriptive video title of three or more words. Not all uppercase."},"media":{"type":"object","properties":{"mediaType":{"type":"string","const":"IMAGE"},"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"UUID of an uploaded APLUS_IMAGES DataFile owned by the action seller or vendor. DataDoe uploads it to Amazon and registers the resulting uploadDestinationId."},"uploadDestinationId":{"type":"string","minLength":1,"description":"Existing Amazon A+ media path from AMAZON_APLUS_CONTENT_FIND (for example aplus-media-library-service-media/…, aplus-media/sc/…, or /images/I/… catalog images)."},"mediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Amazon A+ media asset identifier (mediaId) returned by AMAZON_APLUS_MEDIA_ADD."},"title":{"type":"string","minLength":1}},"required":["mediaType"],"additionalProperties":false,"description":"Thumbnail image shown before the video plays."}},"required":["title","media"],"additionalProperties":false},"description":"Exactly one VIDEO_PAIRING entry with the video thumbnail."},"descriptions":{"minItems":1,"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","pattern":"^[a-z]{2,}-[A-Z0-9]{2,}$"},"value":{"type":"string","minLength":1}},"required":["locale","value"],"additionalProperties":false},"description":"Required by Amazon for every video registration. Must match the existing video-level descriptions; change them with AMAZON_APLUS_MEDIA_UPDATE."}},"required":["mediaType","mediaId","relatedMedia","descriptions"],"additionalProperties":false}],"description":"A+ media asset to register. IMAGE: exactly one of fileId, uploadDestinationId, or mediaId. VIDEO: an existing video mediaId with descriptions and one thumbnail pairing; the response returns the videoMediaId and imageMediaId used by Premium video modules."}}}},{"type":"AMAZON_APLUS_MEDIA_FIND","label":"Find A+ media","group":"aplus-content","entity":"A+ media","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":25},"description":"Retrieve A+ media assets by media ID, including processing status and video pairings.","result":"Media metadata, status, and issues per asset.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Amazon A+ media asset identifier (mediaId) returned by AMAZON_APLUS_MEDIA_ADD."},"associatedMediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Thumbnail mediaId. When provided, relatedMedia contains only this video pairing."}},"required":["mediaId"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},{"type":"AMAZON_APLUS_MEDIA_UPDATE","label":"Update A+ media","group":"aplus-content","entity":"A+ media","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Update the title or the accessibility descriptions of A+ media assets.","result":"Updated media metadata per asset.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Amazon A+ media asset identifier (mediaId) returned by AMAZON_APLUS_MEDIA_ADD."},"associatedMediaId":{"type":"string","minLength":1,"maxLength":100,"description":"Thumbnail mediaId of the video pairing whose title changes. Only valid with title."},"title":{"type":"string","minLength":1,"description":"New title of a standalone image, or of a video pairing when associatedMediaId is set."},"descriptions":{"minItems":1,"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","pattern":"^[a-z]{2,}-[A-Z0-9]{2,}$"},"value":{"type":"string","minLength":1}},"required":["locale","value"],"additionalProperties":false},"description":"Video descriptions upserted by locale. Locales not listed stay unchanged."}},"required":["mediaId"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},{"type":"AMAZON_ORDERS_CANCEL","label":"Cancel order","group":"orders","entity":"Orders","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Cancel an Amazon order item with a given cancellation reason.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cancellations":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestOrderCancellation"}}},"required":["cancellations"],"additionalProperties":false,"$defs":{"ActionRequestOrderCancellation":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"orderItemId":{"type":"string","pattern":"^\\d{1,64}$"},"cancellationReasonCode":{"type":"string","enum":["NoInventory","BuyerCanceled","ShippingAddressUndeliverable","CarrierCoverageFailure","CustomerReturn","CouldNotShip","GeneralAdjustment"]}},"required":["orderId","orderItemId","cancellationReasonCode"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_CONFIRM_SHIPMENT","label":"Confirm shipment","group":"orders","entity":"Orders","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Confirm shipment for an Amazon order item and upload tracking information.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipments":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestShipmentConfirmation"}}},"required":["shipments"],"additionalProperties":false,"$defs":{"ActionRequestShipmentConfirmation":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"orderItemId":{"type":"string","minLength":1,"pattern":"^\\d{1,64}$"},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"shipDate":{"type":"string","minLength":1,"maxLength":32},"carrierCode":{"type":"string","minLength":1,"maxLength":50},"carrierName":{"type":"string","maxLength":256},"shipMethod":{"type":"string","maxLength":256},"trackingNumber":{"type":"string","maxLength":256},"shipFromSupplySourceId":{"type":"string","maxLength":64}},"required":["orderId","orderItemId","quantity","shipDate","carrierCode"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_FIND","label":"Find orders","group":"orders","entity":"Orders","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Live preview of current orders through Amazon `searchOrders`. One search per Action. Pass `paginationToken` to read the next page. Amazon allows about one search every 3 minutes. `marketplaceIds` can include only marketplaces connected as Sellers in this Organization for the same selling partner. Omit `marketplaceIds` to use the connected marketplace. `BUYER`, `RECIPIENT`, and `TAX` require Organization PII access.","result":"The Amazon `searchOrders` payload, including `nextToken` when another page exists.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"searches":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"createdAfter":{"description":"Include orders created at or after this absolute ISO 8601 time.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"createdBefore":{"description":"Include orders created at or before this absolute ISO 8601 time. Must be at least 2 minutes before the request.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastUpdatedAfter":{"description":"Include orders updated at or after this absolute ISO 8601 time.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastUpdatedBefore":{"description":"Include orders updated at or before this absolute ISO 8601 time. Must be at least 2 minutes before the request.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"fulfillmentStatuses":{"minItems":1,"type":"array","items":{"type":"string","enum":["PENDING_AVAILABILITY","PENDING","UNSHIPPED","PARTIALLY_SHIPPED","SHIPPED","CANCELLED","UNFULFILLABLE"]},"description":"Fulfillment statuses to include."},"marketplaceIds":{"description":"Amazon marketplace ids connected as Sellers in this Organization for the same selling partner. Omit this field to use the connected marketplace.","minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1}},"fulfilledBy":{"minItems":1,"type":"array","items":{"type":"string","enum":["MERCHANT","AMAZON"]},"description":"Fulfilling parties to include. MERCHANT is merchant-fulfilled and AMAZON is Amazon-fulfilled."},"maxResultsPerPage":{"description":"Orders per page. Amazon allows 1 to 100 and defaults to 100.","type":"integer","minimum":1,"maximum":100},"paginationToken":{"description":"nextToken from the previous searchOrders page.","type":"string","minLength":1,"maxLength":2048},"includedData":{"minItems":1,"type":"array","items":{"type":"string","enum":["BUYER","RECIPIENT","PROCEEDS","EXPENSE","PROMOTION","CANCELLATION","FULFILLMENT","PACKAGES","TAX","PAYMENT","FULFILLMENT_ORDERS"]},"description":"Extra order datasets to include. Omit this field for basic order data. BUYER, RECIPIENT, and TAX include personal data and require Organization PII access."}},"additionalProperties":false}}},"required":["searches"],"additionalProperties":false,"description":"AMAZON_ORDERS_FIND reads current Amazon orders through Orders API searchOrders. Live preview only. For large volumes and long-term analysis, use Exports or a direct BigQuery integration. Those also refresh during the day. Amazon allows about one search every 3 minutes, so each Action accepts one search. Pass paginationToken from the previous result to read the next page. marketplaceIds can include only marketplaces connected as Sellers in this Organization for the same selling partner. Omit marketplaceIds to use the connected marketplace. BUYER, RECIPIENT, and TAX include personal data and require Organization PII access."}},{"type":"AMAZON_ORDERS_GET_METRICS","label":"Get order metrics","group":"orders","entity":"Order metrics","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":200,"mcp":100},"description":"Live preview of aggregated order metrics. DataDoe fills `marketplaceIds` from the Seller Central connection. Use `from` (inclusive) and `to` (exclusive). Amazon allows about one request every 2 seconds. The API limit fits one 15-minute Action run at that pace.","result":"Aggregated metrics for the connection marketplace.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"queries":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Interval start, inclusive. Absolute ISO 8601 time with Z or an offset."},"to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Interval end, exclusive. Use the same Z or offset notation as from."},"granularity":{"type":"string","enum":["Hour","Day","Week","Month","Year","Total"],"description":"Time bucket. Total aggregates the whole interval."},"granularityTimeZone":{"description":"IANA time zone for day boundaries. Required for Day, Week, Month, and Year. Must be UTC or Etc/UTC when from and to use Z.","type":"string","minLength":1,"maxLength":64},"buyerType":{"type":"string","enum":["B2B","B2C","All"]},"fulfillmentNetwork":{"description":"MFN is merchant-fulfilled and AFN is Amazon-fulfilled. Omit for both.","type":"string","enum":["MFN","AFN"]},"firstDayOfWeek":{"description":"Week start when granularity is Week. Amazon defaults to Monday.","type":"string","enum":["Monday","Sunday"]},"asin":{"description":"Optional ASIN filter. Not format-checked. Cannot be combined with sku.","type":"string","minLength":1,"maxLength":255},"sku":{"description":"Optional SKU filter. Not format-checked. Cannot be combined with asin.","type":"string","minLength":1,"maxLength":255},"amazonProgram":{"type":"string","enum":["AmazonHaul"]}},"required":["from","to","granularity"],"additionalProperties":false}}},"required":["queries"],"additionalProperties":false,"description":"AMAZON_ORDERS_GET_METRICS reads current aggregated order metrics through Sales API getOrderMetrics. Live preview only. For large volumes and long-term analysis, use Exports or a direct BigQuery integration. Those also refresh during the day. DataDoe fills marketplaceIds from the Seller Central connection. Use from (inclusive) and to (exclusive) instead of Amazon's interval string. Amazon allows about one request every 2 seconds. The API limit is sized so a full batch finishes inside the 15-minute Action limit."}},{"type":"AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND","label":"Send review solicitation","group":"buyer-messaging","entity":"Review requests","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":300,"mcp":300},"description":"Send a product review and seller feedback solicitation for an Amazon order.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"solicitations":{"minItems":1,"maxItems":300,"type":"array","items":{"$ref":"#/$defs/ActionRequestSolicitationFeedbackSend"}}},"required":["solicitations"],"additionalProperties":false,"$defs":{"ActionRequestSolicitationFeedbackSend":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"}},"required":["amazonOrderId"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_MESSAGING_ACTIONS_FIND","label":"Find order message actions","group":"buyer-messaging","entity":"Messaging options","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":60,"mcp":20},"description":"List Amazon Messaging actions available for an order, including the schema Amazon returns for each action. Review solicitations stay on `AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND`.","result":"Available action names and schemas.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orders":{"minItems":1,"maxItems":60,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"}},"required":["amazonOrderId"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false,"description":"Lists Amazon message types available for each order, including embedded schemas when Amazon returns them."}},{"type":"AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET","label":"Get order message attributes","group":"buyer-messaging","entity":"Messaging options","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":60,"mcp":20},"description":"Read the buyer locale to use for outbound message text.","result":"Buyer locale.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orders":{"minItems":1,"maxItems":60,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"}},"required":["amazonOrderId"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false,"description":"Reads buyer messaging attributes for each order. The locale is the language to use in outbound messages."}},{"type":"AMAZON_ORDERS_MESSAGES_CUSTOMIZATION_DETAILS_SEND","label":"Send customization details message","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Ask the buyer to provide or verify customization details. Text is optional when at least one `ORDER_MESSAGE_FILES` attachment is included.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses.","type":"string","minLength":1,"maxLength":800},"fileIds":{"description":"UUIDs of uploaded ORDER_MESSAGE_FILES. PDF, PNG, or JPG.","minItems":1,"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["amazonOrderId"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Asks the buyer to provide or verify customization details."}},{"type":"AMAZON_ORDERS_MESSAGES_DELIVERY_DETAILS_SEND","label":"Send delivery details message","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":30,"mcp":10},"description":"Ask the buyer to arrange delivery or confirm delivery contact information.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses."}},"required":["amazonOrderId","text"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Asks the buyer to arrange delivery or confirm delivery contact information."}},{"type":"AMAZON_ORDERS_MESSAGES_ORDER_DETAILS_SEND","label":"Send order details message","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":30,"mcp":10},"description":"Ask an order-related question before shipment.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses."}},"required":["amazonOrderId","text"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Asks an order-related question before shipment."}},{"type":"AMAZON_ORDERS_MESSAGES_SERVICE_DETAILS_SEND","label":"Send service details message","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":30,"mcp":10},"description":"Arrange a Home Service call or gather information before it.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses."}},"required":["amazonOrderId","text"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Arranges a Home Service call or gathers information before it."}},{"type":"AMAZON_ORDERS_MESSAGES_LEGAL_DISCLOSURE_SEND","label":"Send legal disclosure","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Deliver documents a seller is legally required to provide. Attach `ORDER_MESSAGE_FILES` (PDF, PNG, or JPG).","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"fileIds":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":"UUIDs of uploaded ORDER_MESSAGE_FILES. PDF, PNG, or JPG."}},"required":["amazonOrderId","fileIds"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Delivers documents a seller is legally required to provide."}},{"type":"AMAZON_ORDERS_MESSAGES_WARRANTY_SEND","label":"Send warranty","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Send warranty documents. Optional coverage dates must be ISO-8601, and the end date must be on or after the start date.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"fileIds":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":"UUIDs of uploaded ORDER_MESSAGE_FILES. PDF, PNG, or JPG."},"coverageStartDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"coverageEndDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["amazonOrderId","fileIds"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Sends warranty information for a purchase."}},{"type":"AMAZON_ORDERS_MESSAGES_DIGITAL_ACCESS_KEY_SEND","label":"Send digital access key","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Send an access key required for purchased digital content. Provide text, an `ORDER_MESSAGE_FILES` attachment, or both.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses.","type":"string","minLength":1,"maxLength":400},"fileIds":{"description":"UUIDs of uploaded ORDER_MESSAGE_FILES. PDF, PNG, or JPG.","minItems":1,"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["amazonOrderId"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Sends an access key required for purchased digital content."}},{"type":"AMAZON_ORDERS_MESSAGES_UNEXPECTED_PROBLEM_SEND","label":"Send unexpected problem message","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":30,"mcp":10},"description":"Send a critical notice about a problem affecting order completion.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Plain text in the buyer language from AMAZON_ORDERS_MESSAGING_ATTRIBUTES_GET. Do not include HTML or email addresses."}},"required":["amazonOrderId","text"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Sends a critical notice about a problem affecting order completion."}},{"type":"AMAZON_ORDERS_MESSAGES_INVOICE_SEND","label":"Send invoice","group":"buyer-messaging","entity":"Buyer messages","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Send the buyer an invoice. Each file must be a PDF in `ORDER_MESSAGE_FILES`.","result":"Confirmation that Amazon accepted the message.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messages":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonOrderId":{"type":"string","pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"fileIds":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"description":"UUIDs of uploaded ORDER_MESSAGE_FILES PDFs."}},"required":["amazonOrderId","fileIds"],"additionalProperties":false}}},"required":["messages"],"additionalProperties":false,"description":"Sends the buyer an invoice. Each file must be a PDF in ORDER_MESSAGE_FILES."}},{"type":"AMAZON_ORDERS_GET_SHIPPING_RATES","label":"Get FBM shipping rates","group":"fbm-shipping","entity":"FBM shipments","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Get Amazon Buy Shipping rates for an FBM order. Optional `shipDate` is an ISO 8601 date-time with `Z` or an offset for the requested pickup; omit it to rate for now. Copy `format`, `size`, and any `dpi` / `pageLayout` from one print option in `supportedDocumentSpecifications` onto CREATE. Choose `needFileJoining` from its `supportedFileJoiningOptions` and include every mandatory document name from `supportedDocumentDetails` in `requestedDocumentTypes`. `shipFrom.countryCode` is ISO 3166-1 alpha-2 (`GB`, not marketplace `UK`).","result":"Slim rates, ineligible rates, and a requestToken that expires in about 10 minutes.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rateRequests":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbmShippingRateRequest"}}},"required":["rateRequests"],"additionalProperties":false,"description":"Gets Amazon Buy Shipping rates for on-Amazon FBM orders. Optional shipDate on each rate request is the requested pickup as an ISO 8601 date-time; omit it to rate for the current time. Returns a requestToken that expires in about 10 minutes. Copy format, size, file joining, document types, and if needed dpi and pageLayout from the chosen rate supportedDocumentSpecifications onto AMAZON_ORDERS_CREATE_SHIPMENT. Purchase fails if they do not match that rate. Buy the label with that requestToken and rateId so the pickup time, including shipDate, stays bound to the quote.","$defs":{"ActionRequestFbmShippingRateRequest":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"shipDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"ISO 8601 date-time for the requested pickup, with Z or a numeric offset. Omit to rate for the current time. Purchase the label with the requestToken and rateId from this quote. Amazon purchaseShipment has no ship date."},"shipFrom":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"type":"string","minLength":1,"maxLength":60},"addressLine3":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":50},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":32},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code (GB, not marketplace UK)."},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":64}},"required":["name","addressLine1","city","postalCode","countryCode"],"additionalProperties":false},"packages":{"minItems":1,"type":"array","items":{"type":"object","properties":{"packageClientReferenceId":{"type":"string","minLength":1,"maxLength":64},"dimensions":{"type":"object","properties":{"length":{"type":"number","minimum":0.1},"width":{"type":"number","minimum":0.1},"height":{"type":"number","minimum":0.1},"unit":{"type":"string","enum":["INCH","CENTIMETER"]}},"required":["length","width","height","unit"],"additionalProperties":false},"weight":{"type":"object","properties":{"value":{"type":"number","minimum":0.1},"unit":{"type":"string","enum":["GRAM","OUNCE","POUND","KILOGRAM"]}},"required":["value","unit"],"additionalProperties":false},"insuredValue":{"type":"object","properties":{"value":{"type":"number","minimum":0.1},"currency":{"type":"string","minLength":3,"maxLength":3}},"required":["value","currency"],"additionalProperties":false},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"orderItemId":{"type":"string","minLength":1,"pattern":"^\\d{1,64}$"},"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991},"weight":{"type":"object","properties":{"value":{"type":"number","minimum":0.1},"unit":{"type":"string","enum":["GRAM","OUNCE","POUND","KILOGRAM"]}},"required":["value","unit"],"additionalProperties":false},"itemValue":{"type":"object","properties":{"value":{"type":"number","minimum":0.1},"currency":{"type":"string","minLength":3,"maxLength":3}},"required":["value","currency"],"additionalProperties":false},"description":{"type":"string","minLength":1,"maxLength":250}},"required":["orderItemId","quantity","weight","itemValue","description"],"additionalProperties":false}}},"required":["packageClientReferenceId","dimensions","weight","insuredValue","items"],"additionalProperties":false}}},"required":["orderId","shipFrom","packages"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_CREATE_SHIPMENT","label":"Create FBM shipment","group":"fbm-shipping","entity":"FBM shipments","access":"WRITE","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Purchase an Amazon Buy Shipping label for an FBM order. The label uses the pickup time from the quoted rate, including `shipDate` when the quote set one. Pass that rate's `requestToken` and `rateId` before the token expires (~10 minutes). Requires `documentSize` copied from the chosen rate. `needFileJoining` defaults to `true`; `requestedDocumentTypes` defaults to `[\"LABEL\"]`. Include mandatory `PACKSLIP`, `RECEIPT`, or `CUSTOM_FORM` documents when the chosen print option requires them. A missing `pageLayout` stays omitted; copy it when the rate specifies one. If purchase times out, do not buy again; `GET_SHIPMENT_DOCS` only works with a known `shipmentId`.","result":"Shipment and tracking ids, a signed `labelDownloadUrl` valid until `expiresAt` (~15 min). Reprint via `AMAZON_ORDERS_GET_SHIPMENT_DOCS`. Amazon still has the document after the S3 object is gone (7 days).","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"purchases":{"minItems":1,"maxItems":10,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbmShippingPurchase"}}},"required":["purchases"],"additionalProperties":false,"description":"Purchases an Amazon Buy Shipping label. Requires requestToken, rateId, packageClientReferenceId, and documentSize copied from the chosen GET_SHIPPING_RATES rate. That requestToken and rateId bind the pickup time from the quote, including shipDate when one was set. Amazon purchaseShipment has no ship date. Buy before the token expires in about 10 minutes. Do not dump label bytes. labelDownloadUrl is a signed GET valid until expiresAt. After that, call AMAZON_ORDERS_GET_SHIPMENT_DOCS with shipmentId and packageClientReferenceId for a fresh URL.","$defs":{"ActionRequestFbmShippingPurchase":{"type":"object","properties":{"requestToken":{"type":"string","minLength":1,"maxLength":512},"rateId":{"type":"string","minLength":1,"maxLength":256},"carrierId":{"type":"string","minLength":1,"maxLength":64},"packageClientReferenceId":{"type":"string","minLength":1,"maxLength":64},"requestedDocumentFormat":{"default":"PDF","type":"string","enum":["PDF","PNG","ZPL"]},"needFileJoining":{"description":"Choose a value from the selected print option supportedFileJoiningOptions. Defaults to true.","type":"boolean"},"requestedDocumentTypes":{"description":"Include every mandatory document name from the selected print option supportedDocumentDetails. Defaults to [LABEL].","minItems":1,"type":"array","items":{"type":"string","enum":["LABEL","PACKSLIP","RECEIPT","CUSTOM_FORM"]}},"dpi":{"description":"Copy from the chosen rate printOptions when present.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageLayout":{"description":"Copy from the chosen rate printOptions when present.","type":"string","minLength":1,"maxLength":64},"documentSize":{"type":"object","properties":{"width":{"type":"number","minimum":0.1},"length":{"type":"number","minimum":0.1},"unit":{"type":"string","enum":["INCH","CENTIMETER"]}},"required":["width","length","unit"],"additionalProperties":false,"description":"Copy size from the chosen rate supportedDocumentSpecifications. Purchase fails if this does not match that rate."}},"required":["requestToken","rateId","packageClientReferenceId","documentSize"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_GET_SHIPMENT_DOCS","label":"Get FBM shipment documents","group":"fbm-shipping","entity":"FBM shipments","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Re-fetch Amazon Buy Shipping documents when reprinting or when a signed URL expired. Requires a known `shipmentId` and `packageClientReferenceId`.","result":"Document metadata and a fresh signed `labelDownloadUrl` valid until `expiresAt` (~15 min).","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipmentDocuments":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbmShippingShipmentDocumentRequest"}}},"required":["shipmentDocuments"],"additionalProperties":false,"description":"Re-fetches Amazon Buy Shipping documents for reprint or an expired signed URL when shipmentId is already known. Requires shipmentId and packageClientReferenceId. Returns a signed labelDownloadUrl valid until expiresAt.","$defs":{"ActionRequestFbmShippingShipmentDocumentRequest":{"type":"object","properties":{"shipmentId":{"type":"string","minLength":1,"maxLength":64},"packageClientReferenceId":{"type":"string","minLength":1,"maxLength":64},"format":{"type":"string","enum":["PDF","PNG","ZPL"]},"dpi":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["shipmentId","packageClientReferenceId"],"additionalProperties":false}}}},{"type":"AMAZON_ORDERS_CANCEL_SHIPMENT","label":"Cancel FBM shipment","group":"fbm-shipping","entity":"FBM shipments","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Void a paid Amazon Buy Shipping label before carrier scan.","result":"`{ shipmentId, canceled: true }`. Requires `confirm: true`.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cancellations":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbmShippingShipmentCancellation"}}},"required":["cancellations"],"additionalProperties":false,"description":"Voids a paid Amazon Buy Shipping label before carrier scan. confirm must be true.","$defs":{"ActionRequestFbmShippingShipmentCancellation":{"type":"object","properties":{"shipmentId":{"type":"string","minLength":1,"maxLength":64},"confirm":{"type":"boolean","const":true}},"required":["shipmentId","confirm"],"additionalProperties":false}}}},{"type":"AMAZON_SHIPMENT_TRACKING_SUBSCRIBE","label":"Subscribe shipment tracking","group":"fbm-shipping","entity":"Tracking","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":"US marketplace only.","maxItems":{"api":20,"mcp":10},"description":"Subscribe to shipment milestone notifications for tracking identifiers.","result":"Subscription details for each tracking identifier.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"trackingIdentifiers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"aftn":{"type":"string","minLength":1,"maxLength":256},"acsin":{"type":"string","minLength":1,"maxLength":256},"containerNumber":{"type":"string","minLength":1,"maxLength":256},"houseBillOfLadingNumber":{"type":"string","minLength":1,"maxLength":256},"carrierTracking":{"type":"object","properties":{"trackingNumber":{"type":"string","minLength":1,"maxLength":256}},"required":["trackingNumber"],"additionalProperties":false}},"additionalProperties":false}}},"required":["trackingIdentifiers"],"additionalProperties":false}},{"type":"AMAZON_FBA_REMOVAL_ORDERS_ADD","label":"Add FBA removal order","group":"fba-mcf","entity":"Removal orders","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":5000,"mcp":50},"description":"Create an FBA removal order to return, dispose of, or liquidate inventory held in an Amazon fulfillment center.","result":"Confirmation that Amazon accepted the Action.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"removalOrders":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbaRemovalOrder"}}},"required":["removalOrders"],"additionalProperties":false,"$defs":{"ActionRequestFbaRemovalOrder":{"oneOf":[{"type":"object","properties":{"merchantRemovalOrderId":{"type":"string","pattern":"^[A-Za-z0-9]{1,10}$"},"removalDisposition":{"type":"string","const":"return"},"contactPhoneNumber":{"type":"string","minLength":1,"maxLength":32},"shippingNotes":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}]},"address":{"$ref":"#/$defs/ActionRequestFbaRemovalOrderAddress"},"items":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbaRemovalOrderItem"}}},"required":["merchantRemovalOrderId","removalDisposition","contactPhoneNumber","address","items"],"additionalProperties":false},{"type":"object","properties":{"merchantRemovalOrderId":{"type":"string","pattern":"^[A-Za-z0-9]{1,10}$"},"removalDisposition":{"type":"string","const":"dispose"},"shippingNotes":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}]},"items":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbaRemovalOrderItem"}}},"required":["merchantRemovalOrderId","removalDisposition","items"],"additionalProperties":false},{"type":"object","properties":{"merchantRemovalOrderId":{"type":"string","pattern":"^[A-Za-z0-9]{1,10}$"},"removalDisposition":{"type":"string","const":"liquidate"},"shippingNotes":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}]},"items":{"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/$defs/ActionRequestFbaRemovalOrderItem"}}},"required":["merchantRemovalOrderId","removalDisposition","items"],"additionalProperties":false}]},"ActionRequestFbaRemovalOrderAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"addressLine3":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"city":{"type":"string","minLength":1,"maxLength":50},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":32},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"ActionRequestFbaRemovalOrderItem":{"type":"object","properties":{"sku":{"type":"string","minLength":1,"maxLength":64},"sellableQuantity":{"type":"integer","minimum":0,"maximum":9007199254740991},"unsellableQuantity":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sku","sellableQuantity","unsellableQuantity"],"additionalProperties":false}}}},{"type":"AMAZON_MCF_ORDERS_ADD","label":"Add MCF order","group":"fba-mcf","entity":"MCF orders","access":"WRITE","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Create an MCF order so Amazon can pick, pack, and ship FBA inventory to a non-Amazon customer.","result":"Confirmation that Amazon accepted the order.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orders":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"maxLength":40},"channel":{"type":"string","minLength":1,"maxLength":40},"paymentOnDelivery":{"description":"Set true to create an India payment-on-delivery MCF order. Omit or set false for a prepaid order. Requires a connected India Seller account, an India destination, and an INR perUnitServicePrice greater than 0 on every line item. Amazon accepting the order does not mean payment was collected or delivery is complete.","type":"boolean"},"fulfillmentConfiguration":{"type":"object","properties":{"serviceLevel":{"type":"object","properties":{"serviceTiers":{"minItems":1,"type":"array","items":{"type":"string","enum":["STANDARD","EXPEDITED","PRIORITY","SCHEDULED"]}},"deliveryInterval":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"endTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["startTime","endTime"],"additionalProperties":false}},"required":["serviceTiers"],"additionalProperties":false},"action":{"default":"SHIP","type":"string","enum":["SHIP","HOLD"]},"policy":{"default":"FILL_OR_KILL","type":"string","enum":["FILL_OR_KILL","FILL_ALL","FILL_ALL_AVAILABLE"]},"services":{"type":"object","properties":{"packaging":{"type":"object","properties":{"packagingOption":{"type":"string","enum":["UNBRANDED","ANY"]},"overbox":{"type":"string","enum":["REQUIRED","NOT_REQUIRED"]},"packingSlip":{"type":"object","properties":{"templateName":{"type":"string","minLength":1},"templateAttributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"additionalProperties":false}},"additionalProperties":false},"additional":{"type":"object","properties":{"BLOCK_AMZL":{"type":"string","minLength":1},"SIGNATURE_CONFIRMATION":{"type":"string","minLength":1},"DELIVER_TOGETHER":{"type":"string","minLength":1}},"additionalProperties":{"type":"string","minLength":1}}},"additionalProperties":false}},"required":["serviceLevel"],"additionalProperties":false},"destination":{"type":"object","properties":{"deliveryAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"type":"string","minLength":1,"maxLength":60},"addressLine3":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":50},"districtOrCounty":{"type":"string","minLength":1,"maxLength":150},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":64}},"required":["name","addressLine1","postalCode","countryCode"],"additionalProperties":false},"deliveryNotes":{"type":"string","minLength":1,"maxLength":250},"dropOffLocation":{"type":"object","properties":{"type":{"type":"string","enum":["FRONT_DOOR","DELIVERY_BOX","GAS_METER_BOX","BICYCLE_BASKET","GARAGE","RECEPTIONIST","FALLBACK_NEIGHBOR_DELIVERY","DO_NOT_LEAVE_UNATTENDED","LOCKER"]},"attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["type"],"additionalProperties":false}},"required":["deliveryAddress"],"additionalProperties":false},"lineItems":{"minItems":1,"type":"array","items":{"type":"object","properties":{"lineItemId":{"type":"string","minLength":1,"maxLength":50},"product":{"type":"object","properties":{"productIdentifier":{"type":"object","properties":{"amazonSku":{"type":"string","minLength":1,"maxLength":50}},"required":["amazonSku"],"additionalProperties":false},"perUnitDeclaredValue":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["productIdentifier"],"additionalProperties":false},"amount":{"type":"object","properties":{"unit":{"default":"EACHES","type":"string","enum":["EACHES"]},"value":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["value"],"additionalProperties":false},"fulfillmentConfiguration":{"type":"object","properties":{"services":{"type":"object","properties":{"packaging":{"type":"object","properties":{"packingSlip":{"type":"object","properties":{"templateName":{"type":"string","minLength":1},"templateAttributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"additionalProperties":false}},"additionalProperties":false},"delivery":{"type":"object","properties":{"paymentOnDelivery":{"type":"object","properties":{"perUnitServicePrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$","description":"Must be greater than 0."}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["perUnitServicePrice"],"additionalProperties":false,"description":"Per-unit amount the customer pays on delivery. currencyCode must be INR. The amount must be greater than 0. Required on every line item when the order sets paymentOnDelivery to true. A missing price or currency is rejected and is not filled in."}},"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false}},"required":["lineItemId","product","amount"],"additionalProperties":false}}},"required":["orderId","fulfillmentConfiguration","destination","lineItems"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false,"description":"Creates MCF orders. Omit paymentOnDelivery for a prepaid order. Set it to true only for an India Seller account shipping to India, with an INR per-unit service price greater than 0 on every line item. Amazon acceptance does not mean payment was collected or delivery is complete."}},{"type":"AMAZON_MCF_ORDERS_UPDATE","label":"Update MCF order","group":"fba-mcf","entity":"MCF orders","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Hold or ship an existing MCF order.","result":"Confirmation that Amazon accepted the update.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updates":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"maxLength":40},"action":{"type":"string","enum":["SHIP","HOLD"]}},"required":["orderId","action"],"additionalProperties":false}}},"required":["updates"],"additionalProperties":false}},{"type":"AMAZON_MCF_ORDERS_FIND","label":"Find MCF orders","group":"fba-mcf","entity":"MCF orders","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":100,"mcp":25},"description":"Operational lookup of recent MCF orders. **Not for analytics** — warehouse reporting stays in data tables / BigQuery (same rule as listings find). Returns one page per call and does not auto-paginate.","result":"MCF order list or a single order.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orderId":{"description":"When present, fetches a single MCF order via getOrder instead of listOrders.","type":"string","minLength":1,"maxLength":40},"updatedAfter":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"pageToken":{"type":"string","minLength":1},"shipments":{"default":"INCLUDE","type":"string","enum":["INCLUDE","EXCLUDE"]}},"additionalProperties":false,"description":"Operational lookup of recent MCF orders. Not for analytics — warehouse reporting stays in BigQuery. Returns one page per call and does not auto-paginate."}},{"type":"AMAZON_MCF_ORDERS_CANCEL","label":"Cancel MCF order","group":"fba-mcf","entity":"MCF orders","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":50,"mcp":20},"description":"Cancel an MCF order.","result":"Confirmation that Amazon accepted the cancellation.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cancellations":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"maxLength":40}},"required":["orderId"],"additionalProperties":false}}},"required":["cancellations"],"additionalProperties":false}},{"type":"AMAZON_MCF_ORDERS_PREVIEW","label":"Preview MCF order","group":"fba-mcf","entity":"MCF orders","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Draft a full MCF order preview (`getOrderPreview`) including line items and destination.","result":"Amazon order preview, including estimated fees.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"channel":{"type":"string","minLength":1,"maxLength":40},"fulfillmentConfiguration":{"type":"object","properties":{"serviceLevel":{"type":"object","properties":{"serviceTiers":{"minItems":1,"type":"array","items":{"type":"string","enum":["STANDARD","EXPEDITED","PRIORITY","SCHEDULED"]}}},"additionalProperties":false},"services":{"type":"object","properties":{"packaging":{"type":"object","properties":{"packagingOption":{"type":"string","enum":["UNBRANDED","ANY"]},"overbox":{"type":"string","enum":["REQUIRED","NOT_REQUIRED"]},"packingSlip":{"type":"object","properties":{"templateName":{"type":"string","minLength":1},"templateAttributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"additionalProperties":false}},"additionalProperties":false},"additional":{"type":"object","properties":{"BLOCK_AMZL":{"type":"string","minLength":1},"SIGNATURE_CONFIRMATION":{"type":"string","minLength":1},"DELIVER_TOGETHER":{"type":"string","minLength":1}},"additionalProperties":{"type":"string","minLength":1}}},"additionalProperties":false}},"additionalProperties":false},"destination":{"type":"object","properties":{"deliveryAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"type":"string","minLength":1,"maxLength":60},"addressLine3":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":50},"districtOrCounty":{"type":"string","minLength":1,"maxLength":150},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":64}},"required":["name","addressLine1","postalCode","countryCode"],"additionalProperties":false}},"required":["deliveryAddress"],"additionalProperties":false},"lineItems":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"product":{"type":"object","properties":{"productIdentifier":{"type":"object","properties":{"amazonSku":{"type":"string","minLength":1,"maxLength":50}},"required":["amazonSku"],"additionalProperties":false},"perUnitDeclaredValue":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["productIdentifier"],"additionalProperties":false},"amount":{"type":"object","properties":{"unit":{"default":"EACHES","type":"string","enum":["EACHES"]},"value":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["value"],"additionalProperties":false}},"required":["product","amount"],"additionalProperties":false}},"excludeEstimatedFees":{"default":false,"type":"boolean"},"includePaymentOnDelivery":{"description":"Set true to include India payment-on-delivery availability in the preview. Amazon returns ENABLED or DISABLED on each offer, and any constraints. Omit or set false for a prepaid preview. A preview does not create an order or collect payment.","type":"boolean"}},"required":["destination","lineItems"],"additionalProperties":false,"description":"Drafts a full MCF order preview (line items + destination) in a single getOrderPreview call. includePaymentOnDelivery is only for an India Seller account shipping to India. Creating the order is a separate AMAZON_MCF_ORDERS_ADD request."}},{"type":"AMAZON_MCF_DELIVERY_OFFERS_PREVIEW","label":"Preview MCF delivery offers","group":"fba-mcf","entity":"MCF orders","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Retrieve MCF delivery offers (`getOffers`) for one or more SKUs. Origin is taken from the connection marketplace.","result":"Amazon delivery offers.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fulfillmentConfiguration":{"type":"object","properties":{"serviceLevel":{"type":"object","properties":{"serviceTiers":{"minItems":1,"type":"array","items":{"type":"string","enum":["STANDARD","EXPEDITED","PRIORITY","SCHEDULED"]}}},"additionalProperties":false},"services":{"type":"object","properties":{"packaging":{"type":"object","properties":{"packagingOption":{"type":"string","enum":["UNBRANDED","ANY"]},"overbox":{"type":"string","enum":["REQUIRED","NOT_REQUIRED"]},"packingSlip":{"type":"object","properties":{"templateName":{"type":"string","minLength":1},"templateAttributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"additionalProperties":false}},"additionalProperties":false},"additional":{"type":"object","properties":{"BLOCK_AMZL":{"type":"string","minLength":1},"SIGNATURE_CONFIRMATION":{"type":"string","minLength":1},"DELIVER_TOGETHER":{"type":"string","minLength":1}},"additionalProperties":{"type":"string","minLength":1}}},"additionalProperties":false}},"additionalProperties":false},"destination":{"type":"object","properties":{"deliveryAddress":{"type":"object","properties":{"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"type":"string","minLength":1,"maxLength":60},"addressLine3":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":50},"districtOrCounty":{"type":"string","minLength":1,"maxLength":150},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2}},"required":["postalCode","countryCode"],"additionalProperties":false},"ipAddress":{"type":"string","minLength":1}},"additionalProperties":false},"items":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"amazonSku":{"type":"string","minLength":1,"maxLength":50}},"required":["amazonSku"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false,"description":"Retrieves MCF delivery offers for one or more SKUs in a single getOffers call. Origin is taken from the connection marketplace."}},{"type":"AMAZON_MCF_RETURNS_REASON_CODES_FIND","label":"Find MCF return reason codes","group":"fba-mcf","entity":"MCF returns","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Look up MCF return reason codes via Fulfillment Outbound **v2020-07-01** (`listReturnReasonCodes`). Marketplace comes from the connection.","result":"Return reason codes per SKU.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonSku":{"type":"string","minLength":1,"maxLength":50},"orderId":{"type":"string","minLength":1,"maxLength":40}},"required":["amazonSku"],"additionalProperties":false}},"language":{"type":"string","minLength":1,"maxLength":16,"pattern":"^[a-z]{2,3}(_([A-Z]{2}|[0-9]{3}))?(@.+)?$"}},"required":["items"],"additionalProperties":false,"description":"Looks up MCF return reason codes via Fulfillment Outbound v2020-07-01 listReturnReasonCodes. v2026 has no returns API. Marketplace comes from the connection."}},{"type":"AMAZON_MCF_RETURNS_ADD","label":"Add MCF return","group":"fba-mcf","entity":"MCF returns","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Create an MCF fulfillment return via Fulfillment Outbound **v2020-07-01** (`createFulfillmentReturn`).","result":"Confirmation that Amazon accepted the return.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"returns":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","minLength":1,"maxLength":40},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"lineItemId":{"type":"string","minLength":1,"maxLength":50},"amazonShipmentId":{"type":"string","minLength":1,"maxLength":50},"returnReasonCode":{"type":"string","minLength":1,"maxLength":50},"returnComment":{"type":"string","minLength":1,"maxLength":1000}},"required":["lineItemId","amazonShipmentId","returnReasonCode"],"additionalProperties":false}}},"required":["orderId","items"],"additionalProperties":false}}},"required":["returns"],"additionalProperties":false,"description":"Creates MCF fulfillment returns via Fulfillment Outbound v2020-07-01 createFulfillmentReturn. v2026 has no returns API. sellerReturnItemId is generated server-side."}},{"type":"AMAZON_MCF_FEATURES_MARKETPLACE_FIND","label":"Find MCF marketplace features","group":"fba-mcf","entity":"MCF features","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Return the static catalog of v2026 MCF `fulfillmentConfiguration.services` options. Does not call Amazon.","result":"Static services catalog.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"description":"Returns the static catalog of v2026 MCF fulfillmentConfiguration.services options. Does not call Amazon."}},{"type":"AMAZON_MCF_FEATURES_SKU_FIND","label":"Find MCF SKU features","group":"fba-mcf","entity":"MCF features","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Check whether a SKU is sellable and what quantity Amazon can fulfill, using `getOrderPreview` as a proxy. Not a full MCF order draft — use `AMAZON_MCF_ORDERS_PREVIEW` for that.","result":"Preview-backed sellability and quantity per SKU.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"amazonSku":{"type":"string","minLength":1,"maxLength":50},"amount":{"type":"object","properties":{"unit":{"default":"EACHES","type":"string","enum":["EACHES"]},"value":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["value"],"additionalProperties":false},"destination":{"type":"object","properties":{"deliveryAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"addressLine1":{"type":"string","minLength":1,"maxLength":60},"addressLine2":{"type":"string","minLength":1,"maxLength":60},"addressLine3":{"type":"string","minLength":1,"maxLength":60},"city":{"type":"string","minLength":1,"maxLength":50},"districtOrCounty":{"type":"string","minLength":1,"maxLength":150},"stateOrRegion":{"type":"string","minLength":1,"maxLength":50},"postalCode":{"type":"string","minLength":1,"maxLength":20},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":64}},"required":["name","addressLine1","postalCode","countryCode"],"additionalProperties":false}},"required":["deliveryAddress"],"additionalProperties":false}},"required":["amazonSku","destination"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false,"description":"Checks whether a SKU is sellable and what quantity Amazon can fulfill. Not a full MCF order draft — use AMAZON_MCF_ORDERS_PREVIEW for that."}},{"type":"AMAZON_VENDOR_PURCHASE_ORDERS_ACKNOWLEDGE","label":"Acknowledge vendor purchase order","group":"vendor-purchase-orders","entity":"Purchase orders","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Acknowledge Retail Procurement purchase orders. A rejected line requires a rejection reason.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"acknowledgements":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxInfo":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"required":["partyId"],"additionalProperties":false},"acknowledgementDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"amazonProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"orderedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"netCost":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]}},"additionalProperties":false},"listPrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]}},"additionalProperties":false},"discountMultiplier":{"type":"string","minLength":1},"itemAcknowledgements":{"minItems":1,"type":"array","items":{"type":"object","properties":{"acknowledgementCode":{"type":"string","enum":["Accepted","Backordered","Rejected"]},"acknowledgedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"scheduledShipDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"scheduledDeliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"rejectionReason":{"type":"string","enum":["TemporarilyUnavailable","InvalidProductIdentifier","ObsoleteProduct"]}},"required":["acknowledgementCode","acknowledgedQuantity"],"additionalProperties":false}}},"required":["itemSequenceNumber","orderedQuantity","itemAcknowledgements"],"additionalProperties":false}}},"required":["purchaseOrderNumber","sellingParty","acknowledgementDate","items"],"additionalProperties":false}}},"required":["acknowledgements"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_SHIPMENTS_SUBMIT","label":"Submit vendor shipment request","group":"vendor-purchase-orders","entity":"Shipments","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Submit a Retail Procurement shipment request. Transaction type is New or Cancel.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipments":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"vendorShipmentIdentifier":{"type":"string","minLength":1},"transactionType":{"type":"string","enum":["New","Cancel"]},"buyerReferenceNumber":{"type":"string","minLength":1},"transactionDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"currentShipmentStatus":{"type":"string","enum":["Created","TransportationRequested","CarrierAssigned","Shipped"]},"currentshipmentStatusDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipmentStatusDetails":{"type":"array","items":{"type":"object","properties":{"shipmentStatus":{"type":"string","enum":["Created","TransportationRequested","CarrierAssigned","Shipped"]},"shipmentStatusDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"additionalProperties":false}},"shipmentCreateDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipmentConfirmDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"packageLabelCreateDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipmentFreightTerm":{"type":"string","enum":["Collect","Prepaid"]},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipmentMeasurements":{"type":"object","properties":{"totalCartonCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPalletStackable":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPalletNonStackable":{"type":"integer","minimum":0,"maximum":9007199254740991},"shipmentWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"shipmentVolume":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["CuFt","CuIn","CuM","CuY"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false}},"additionalProperties":false},"collectFreightPickupDetails":{"type":"object","properties":{"requestedPickUp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"scheduledPickUp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"carrierAssignmentDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"additionalProperties":false},"purchaseOrders":{"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"purchaseOrderDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipWindow":{"type":"string","minLength":1},"items":{"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"buyerProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"shippedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"maximumRetailPrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["itemSequenceNumber","shippedQuantity"],"additionalProperties":false}}},"additionalProperties":false}},"importDetails":{"type":"object","properties":{"methodOfPayment":{"type":"string","enum":["PaidByBuyer","CollectOnDelivery","DefinedByBuyerAndSeller","FOBPortOfCall","PrepaidBySeller","PaidBySeller"]},"sealNumber":{"type":"string","minLength":1},"route":{"type":"object","properties":{"stops":{"minItems":1,"type":"array","items":{"type":"object","properties":{"functionCode":{"type":"string","enum":["PortOfDischarge","FreightPayableAt","PortOfLoading"]},"locationIdentification":{"type":"object","properties":{"type":{"type":"string","minLength":1},"locationCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2}},"additionalProperties":false},"arrivalTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"departureTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["functionCode"],"additionalProperties":false}}},"required":["stops"],"additionalProperties":false},"importContainers":{"type":"string","minLength":1},"billableWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"estimatedShipByDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"handlingInstructions":{"type":"string","enum":["Oversized","Fragile","Food","HandleWithCare"]}},"additionalProperties":false},"containers":{"type":"array","items":{"type":"object","properties":{"containerType":{"type":"string","enum":["carton","pallet"]},"containerSequenceNumber":{"type":"string","minLength":1},"containerIdentifiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"containerIdentificationType":{"type":"string","enum":["SSCC","AMZNCC","GTIN","BPS","CID"]},"containerIdentificationNumber":{"type":"string","minLength":1}},"required":["containerIdentificationType","containerIdentificationNumber"],"additionalProperties":false}},"trackingNumber":{"type":"string","minLength":1},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["In","Ft","Meter","Yard"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"tier":{"type":"integer","minimum":0,"maximum":9007199254740991},"block":{"type":"integer","minimum":0,"maximum":9007199254740991},"innerContainersDetails":{"type":"object","properties":{"containerCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"containerSequenceNumbers":{"type":"array","items":{"type":"object","properties":{"containerSequenceNumber":{"type":"string","minLength":1}},"additionalProperties":false}}},"additionalProperties":false},"packedItems":{"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"buyerProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"packedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"itemDetails":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"lotNumber":{"type":"string","minLength":1},"expiry":{"type":"object","properties":{"manufacturerDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryAfterDuration":{"type":"object","properties":{"durationUnit":{"type":"string","enum":["Days","Months"]},"durationValue":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["durationUnit","durationValue"],"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false}}},"required":["containerType","containerIdentifiers"],"additionalProperties":false}},"transportationDetails":{"type":"object","properties":{"shipMode":{"type":"string","enum":["TruckLoad","LessThanTruckLoad","SmallParcel"]},"transportationMode":{"type":"string","enum":["Road","Air","Ocean"]},"shippedDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"estimatedDeliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipmentDeliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"carrierDetails":{"type":"object","properties":{"name":{"type":"string","minLength":1},"code":{"type":"string","minLength":1},"phone":{"type":"string","minLength":1},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"shipmentReferenceNumber":{"type":"string","minLength":1}},"additionalProperties":false},"billOfLadingNumber":{"type":"string","minLength":1}},"additionalProperties":false}},"required":["vendorShipmentIdentifier","transactionType","transactionDate","sellingParty","shipFromParty","shipToParty"],"additionalProperties":false}}},"required":["shipments"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_SHIPMENT_CONFIRMATIONS_SUBMIT","label":"Submit vendor shipment confirmation","group":"vendor-purchase-orders","entity":"Shipments","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Submit a Retail Procurement shipment confirmation (ASN).","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipmentConfirmations":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"shipmentIdentifier":{"type":"string","minLength":1},"shipmentConfirmationType":{"type":"string","enum":["Original","Replace"]},"shipmentType":{"type":"string","enum":["TruckLoad","LessThanTruckLoad","SmallParcel"]},"shipmentStructure":{"type":"string","enum":["PalletizedAssortmentCase","LooseAssortmentCase","PalletOfItems","PalletizedStandardCase","LooseStandardCase","MasterPallet","MasterCase"]},"transportationDetails":{"type":"object","properties":{"carrierScac":{"type":"string","minLength":1},"carrierShipmentReferenceNumber":{"type":"string","minLength":1},"transportationMode":{"type":"string","enum":["Road","Air","Ocean"]},"billOfLadingNumber":{"type":"string","minLength":1}},"additionalProperties":false},"amazonReferenceNumber":{"type":"string","minLength":1},"shipmentConfirmationDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shippedDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"estimatedDeliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipmentMeasurements":{"type":"object","properties":{"grossShipmentWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"shipmentVolume":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["CuFt","CuIn","CuM","CuY"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"cartonCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"palletCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false},"importDetails":{"type":"object","properties":{"methodOfPayment":{"type":"string","enum":["PaidByBuyer","CollectOnDelivery","DefinedByBuyerAndSeller","FOBPortOfCall","PrepaidBySeller","PaidBySeller"]},"sealNumber":{"type":"string","minLength":1},"route":{"type":"object","properties":{"stops":{"minItems":1,"type":"array","items":{"type":"object","properties":{"functionCode":{"type":"string","enum":["PortOfDischarge","FreightPayableAt","PortOfLoading"]},"locationIdentification":{"type":"object","properties":{"type":{"type":"string","minLength":1},"locationCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2}},"additionalProperties":false},"arrivalTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"departureTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["functionCode"],"additionalProperties":false}}},"required":["stops"],"additionalProperties":false},"importContainers":{"type":"string","minLength":1},"billableWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"estimatedShipByDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"handlingInstructions":{"type":"string","enum":["Oversized","Fragile","Food","HandleWithCare"]}},"additionalProperties":false},"shippedItems":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"amazonProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"shippedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"itemDetails":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"lotNumber":{"type":"string","minLength":1},"lotNumberSourceReference":{"type":"string","minLength":1},"lotNumberSourceType":{"type":"string","enum":["GLN","FFRN","USDA_E","URL"]},"countryOfOrigin":{"type":"string","minLength":2,"maxLength":2},"regulationReferences":{"type":"object","properties":{"dueDiligenceReference":{"type":"string","minLength":1},"dueDiligenceVerification":{"type":"string","minLength":1},"dueDiligenceInformation":{"type":"string","minLength":1},"dueDiligenceExemptionCode":{"type":"string","minLength":1}},"additionalProperties":false},"expiry":{"type":"object","properties":{"manufacturerDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryAfterDuration":{"type":"object","properties":{"durationUnit":{"type":"string","enum":["Days","Months"]},"durationValue":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["durationUnit","durationValue"],"additionalProperties":false}},"additionalProperties":false},"maximumRetailPrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"handlingCode":{"type":"string","enum":["Oversized","Fragile","Food","HandleWithCare"]}},"additionalProperties":false}},"required":["itemSequenceNumber","shippedQuantity"],"additionalProperties":false}},"cartons":{"type":"array","items":{"type":"object","properties":{"cartonIdentifiers":{"type":"array","items":{"type":"object","properties":{"containerIdentificationType":{"type":"string","enum":["SSCC","AMZNCC","GTIN","BPS","CID"]},"containerIdentificationNumber":{"type":"string","minLength":1}},"required":["containerIdentificationType","containerIdentificationNumber"],"additionalProperties":false}},"cartonSequenceNumber":{"type":"string","minLength":1},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["In","Ft","Meter","Yard"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"trackingNumber":{"type":"string","minLength":1},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemReference":{"type":"string","minLength":1},"shippedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"itemDetails":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"lotNumber":{"type":"string","minLength":1},"lotNumberSourceReference":{"type":"string","minLength":1},"lotNumberSourceType":{"type":"string","enum":["GLN","FFRN","USDA_E","URL"]},"countryOfOrigin":{"type":"string","minLength":2,"maxLength":2},"regulationReferences":{"type":"object","properties":{"dueDiligenceReference":{"type":"string","minLength":1},"dueDiligenceVerification":{"type":"string","minLength":1},"dueDiligenceInformation":{"type":"string","minLength":1},"dueDiligenceExemptionCode":{"type":"string","minLength":1}},"additionalProperties":false},"expiry":{"type":"object","properties":{"manufacturerDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryAfterDuration":{"type":"object","properties":{"durationUnit":{"type":"string","enum":["Days","Months"]},"durationValue":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["durationUnit","durationValue"],"additionalProperties":false}},"additionalProperties":false},"maximumRetailPrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"handlingCode":{"type":"string","enum":["Oversized","Fragile","Food","HandleWithCare"]}},"additionalProperties":false}},"required":["itemReference","shippedQuantity"],"additionalProperties":false}}},"required":["cartonSequenceNumber","items"],"additionalProperties":false}},"pallets":{"type":"array","items":{"type":"object","properties":{"palletIdentifiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"containerIdentificationType":{"type":"string","enum":["SSCC","AMZNCC","GTIN","BPS","CID"]},"containerIdentificationNumber":{"type":"string","minLength":1}},"required":["containerIdentificationType","containerIdentificationNumber"],"additionalProperties":false}},"tier":{"type":"integer","minimum":0,"maximum":9007199254740991},"block":{"type":"integer","minimum":0,"maximum":9007199254740991},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["In","Ft","Meter","Yard"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["G","Kg","Oz","Lb"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"cartonReferenceDetails":{"type":"object","properties":{"cartonCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"cartonReferenceNumbers":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}}},"required":["cartonReferenceNumbers"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"itemReference":{"type":"string","minLength":1},"shippedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"itemDetails":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"lotNumber":{"type":"string","minLength":1},"lotNumberSourceReference":{"type":"string","minLength":1},"lotNumberSourceType":{"type":"string","enum":["GLN","FFRN","USDA_E","URL"]},"countryOfOrigin":{"type":"string","minLength":2,"maxLength":2},"regulationReferences":{"type":"object","properties":{"dueDiligenceReference":{"type":"string","minLength":1},"dueDiligenceVerification":{"type":"string","minLength":1},"dueDiligenceInformation":{"type":"string","minLength":1},"dueDiligenceExemptionCode":{"type":"string","minLength":1}},"additionalProperties":false},"expiry":{"type":"object","properties":{"manufacturerDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiryAfterDuration":{"type":"object","properties":{"durationUnit":{"type":"string","enum":["Days","Months"]},"durationValue":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["durationUnit","durationValue"],"additionalProperties":false}},"additionalProperties":false},"maximumRetailPrice":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"handlingCode":{"type":"string","enum":["Oversized","Fragile","Food","HandleWithCare"]}},"additionalProperties":false}},"required":["itemReference","shippedQuantity"],"additionalProperties":false}}},"required":["palletIdentifiers"],"additionalProperties":false}}},"required":["shipmentIdentifier","shipmentConfirmationType","shipmentConfirmationDate","sellingParty","shipFromParty","shipToParty","shippedItems"],"additionalProperties":false}}},"required":["shipmentConfirmations"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_SHIPMENT_LABELS_GET","label":"Get vendor shipment labels","group":"vendor-purchase-orders","entity":"Shipments","access":"READ","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Download Retail Procurement shipping labels. Each query needs a date window, buyer reference, shipment id, or warehouse.","result":"Label documents.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"labelQueries":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"sortOrder":{"type":"string","enum":["ASC","DESC"]},"labelCreatedAfter":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"labelCreatedBefore":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"buyerReferenceNumber":{"type":"string","minLength":1},"vendorShipmentIdentifier":{"type":"string","minLength":1},"sellerWarehouseCode":{"type":"string","minLength":1}},"additionalProperties":false}}},"required":["labelQueries"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_TRANSACTIONS_GET","label":"Get vendor transaction status","group":"vendor-purchase-orders","entity":"Transactions","access":"READ","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Read the status of a Retail Procurement submit transaction.","result":"Transaction status.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transactionIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1}}},"required":["transactionIds"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_INVOICES_SUBMIT","label":"Submit vendor invoice","group":"vendor-purchase-orders","entity":"Invoices","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Submit a Retail Procurement invoice or credit note. Amazon returns a transaction id.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"invoices":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"invoiceType":{"type":"string","enum":["Invoice","CreditNote"]},"id":{"type":"string","minLength":1},"referenceNumber":{"type":"string","minLength":1},"date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"remitToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"billToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"billFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"vatGroupParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"taxRepresentativeParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalOrZipCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1}},"required":["taxRegistrationType","taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"paymentTerms":{"type":"object","properties":{"type":{"type":"string","enum":["Basic","EndOfMonth","FixedDate","Proximo","PaymentDueUponReceiptOfInvoice","LetterofCredit"]},"discountPercent":{"type":"string","minLength":1},"discountDueDays":{"type":"integer","minimum":0,"maximum":9007199254740991},"netDueDays":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false},"invoiceTotal":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"invoiceBaseAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxPointDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}},"additionalDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["SUR","OCR","CartonCount","TaxExemptReason","LegalTerms","RegulatoryNote"]},"detail":{"type":"string","minLength":1},"languageCode":{"type":"string","minLength":1}},"required":["type","detail"],"additionalProperties":false}},"chargeDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Freight","Packing","Duty","Service","SmallOrder","InsurancePlacementCost","InsuranceFee","SpecialHandlingService","CollectionAndRecyclingService","EnvironmentalProtectionService","TaxCollectedAtSource"]},"description":{"type":"string","minLength":1},"chargeAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","chargeAmount"],"additionalProperties":false}},"allowanceDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Discount","DiscountIncentive","Defective","Promotional","UnsaleableMerchandise","Special"]},"description":{"type":"string","minLength":1},"allowanceAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","allowanceAmount"],"additionalProperties":false}},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"amazonProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"invoicedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","enum":["Cases","Eaches"]},"unitSize":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]},"totalWeight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"amount":{"type":"string","minLength":1}},"required":["unitOfMeasure","amount"],"additionalProperties":false}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"netCost":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"netCostUnitOfMeasure":{"type":"string","enum":["POUNDS","OUNCES","GRAMS","KILOGRAMS"]},"purchaseOrderNumber":{"type":"string","minLength":1},"hsnCode":{"type":"string","minLength":1},"itemDescription":{"type":"string","minLength":1},"additionalDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["SUR","OCR","CartonCount","TaxExemptReason","LegalTerms","RegulatoryNote"]},"detail":{"type":"string","minLength":1},"languageCode":{"type":"string","minLength":1}},"required":["type","detail"],"additionalProperties":false}},"creditNoteDetails":{"type":"object","properties":{"referenceInvoiceNumber":{"type":"string","minLength":1},"originalInvoiceDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"debitNoteNumber":{"type":"string","minLength":1},"returnsReferenceNumber":{"type":"string","minLength":1},"goodsReturnDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"rmaId":{"type":"string","minLength":1},"coopReferenceNumber":{"type":"string","minLength":1},"consignorsReferenceNumber":{"type":"string","minLength":1}},"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}},"chargeDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Freight","Packing","Duty","Service","SmallOrder","InsurancePlacementCost","InsuranceFee","SpecialHandlingService","CollectionAndRecyclingService","EnvironmentalProtectionService","TaxCollectedAtSource"]},"description":{"type":"string","minLength":1},"chargeAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","chargeAmount"],"additionalProperties":false}},"allowanceDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Discount","DiscountIncentive","Defective","Promotional","UnsaleableMerchandise","Special"]},"description":{"type":"string","minLength":1},"allowanceAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","allowanceAmount"],"additionalProperties":false}}},"required":["itemSequenceNumber","invoicedQuantity","netCost"],"additionalProperties":false}}},"required":["invoiceType","id","date","remitToParty","invoiceTotal","items"],"additionalProperties":false}}},"required":["invoices"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_ORDERS_ACKNOWLEDGE","label":"Acknowledge direct fulfillment order","group":"vendor-direct-fulfillment","entity":"Orders","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Acknowledge Direct Fulfillment orders. Status code is two digits, such as 00 (accept) or 03 (out of stock).","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"acknowledgements":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"vendorOrderNumber":{"type":"string","minLength":1},"acknowledgementDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"acknowledgementStatus":{"type":"object","properties":{"code":{"type":"string","pattern":"^\\d{2}$"},"description":{"type":"string","minLength":1}},"required":["code","description"],"additionalProperties":false},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"itemAcknowledgements":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"buyerProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"acknowledgedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","const":"Each"}},"required":["amount","unitOfMeasure"],"additionalProperties":false}},"required":["itemSequenceNumber","acknowledgedQuantity"],"additionalProperties":false}}},"required":["purchaseOrderNumber","vendorOrderNumber","acknowledgementDate","acknowledgementStatus","sellingParty","shipFromParty","itemAcknowledgements"],"additionalProperties":false}}},"required":["acknowledgements"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_SHIPPING_LABELS_CREATE","label":"Create direct fulfillment shipping label","group":"vendor-direct-fulfillment","entity":"Labels and packing slips","access":"WRITE","requiresPii":true,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Create Direct Fulfillment shipping labels and receive them in the response.","result":"Shipping label content.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shippingLabels":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"containers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"containerType":{"type":"string","enum":["Carton","Pallet"]},"containerIdentifier":{"type":"string","minLength":1},"trackingNumber":{"type":"string","minLength":1},"manifestId":{"type":"string","minLength":1},"manifestDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipMethod":{"type":"string","minLength":1},"scacCode":{"type":"string","minLength":1},"carrier":{"type":"string","minLength":1},"containerSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["IN","CM"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["KG","LB"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"packedItems":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"buyerProductIdentifier":{"type":"string","minLength":1},"pieceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"vendorProductIdentifier":{"type":"string","minLength":1},"packedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","minLength":1}},"required":["amount","unitOfMeasure"],"additionalProperties":false}},"required":["itemSequenceNumber","packedQuantity"],"additionalProperties":false}}},"required":["containerType","containerIdentifier","weight","packedItems"],"additionalProperties":false}}},"required":["purchaseOrderNumber","sellingParty","shipFromParty"],"additionalProperties":false}}},"required":["shippingLabels"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_SHIPPING_LABEL_REQUESTS_SUBMIT","label":"Request direct fulfillment shipping label","group":"vendor-direct-fulfillment","entity":"Labels and packing slips","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Request Direct Fulfillment shipping labels. Amazon returns a transaction id.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shippingLabelRequests":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"containers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"containerType":{"type":"string","enum":["Carton","Pallet"]},"containerIdentifier":{"type":"string","minLength":1},"trackingNumber":{"type":"string","minLength":1},"manifestId":{"type":"string","minLength":1},"manifestDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipMethod":{"type":"string","minLength":1},"scacCode":{"type":"string","minLength":1},"carrier":{"type":"string","minLength":1},"containerSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["IN","CM"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["KG","LB"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"packedItems":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"buyerProductIdentifier":{"type":"string","minLength":1},"pieceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"vendorProductIdentifier":{"type":"string","minLength":1},"packedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","minLength":1}},"required":["amount","unitOfMeasure"],"additionalProperties":false}},"required":["itemSequenceNumber","packedQuantity"],"additionalProperties":false}}},"required":["containerType","containerIdentifier","weight","packedItems"],"additionalProperties":false}}},"required":["purchaseOrderNumber","sellingParty","shipFromParty"],"additionalProperties":false}}},"required":["shippingLabelRequests"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_SHIPPING_LABEL_GET","label":"Get direct fulfillment shipping label","group":"vendor-direct-fulfillment","entity":"Labels and packing slips","access":"READ","requiresPii":true,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Retrieve a Direct Fulfillment shipping label by purchase order number.","result":"Shipping label content.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"purchaseOrderNumbers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1}}},"required":["purchaseOrderNumbers"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_SHIPMENT_CONFIRMATIONS_SUBMIT","label":"Confirm direct fulfillment shipment","group":"vendor-direct-fulfillment","entity":"Shipments","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Confirm a Direct Fulfillment shipment.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipmentConfirmations":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"shipmentDetails":{"type":"object","properties":{"shippedDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipmentStatus":{"type":"string","enum":["SHIPPED","FLOOR_DENIAL"]},"isPriorityShipment":{"type":"boolean"},"vendorOrderNumber":{"type":"string","minLength":1},"estimatedDeliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["shippedDate","shipmentStatus"],"additionalProperties":false},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"buyerProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"shippedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","minLength":1}},"required":["amount","unitOfMeasure"],"additionalProperties":false}},"required":["itemSequenceNumber","shippedQuantity"],"additionalProperties":false}},"containers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"containerType":{"type":"string","enum":["Carton","Pallet"]},"containerIdentifier":{"type":"string","minLength":1},"trackingNumber":{"type":"string","minLength":1},"manifestId":{"type":"string","minLength":1},"manifestDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"shipMethod":{"type":"string","minLength":1},"scacCode":{"type":"string","minLength":1},"carrier":{"type":"string","minLength":1},"containerSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dimensions":{"type":"object","properties":{"length":{"type":"string","minLength":1},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"unitOfMeasure":{"type":"string","enum":["IN","CM"]}},"required":["length","width","height","unitOfMeasure"],"additionalProperties":false},"weight":{"type":"object","properties":{"unitOfMeasure":{"type":"string","enum":["KG","LB"]},"value":{"type":"string","minLength":1}},"required":["unitOfMeasure","value"],"additionalProperties":false},"packedItems":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"buyerProductIdentifier":{"type":"string","minLength":1},"pieceNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"vendorProductIdentifier":{"type":"string","minLength":1},"packedQuantity":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"unitOfMeasure":{"type":"string","minLength":1}},"required":["amount","unitOfMeasure"],"additionalProperties":false}},"required":["itemSequenceNumber","packedQuantity"],"additionalProperties":false}}},"required":["containerType","containerIdentifier","weight","packedItems"],"additionalProperties":false}}},"required":["purchaseOrderNumber","shipmentDetails","sellingParty","shipFromParty","items"],"additionalProperties":false}}},"required":["shipmentConfirmations"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_SHIPMENT_STATUS_UPDATES_SUBMIT","label":"Update direct fulfillment shipment status","group":"vendor-direct-fulfillment","entity":"Shipments","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Send a Direct Fulfillment shipment status update for Vendor Own Carrier.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shipmentStatusUpdates":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"purchaseOrderNumber":{"type":"string","minLength":1},"sellingParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"minItems":1,"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"attention":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","stateOrRegion","countryCode"],"additionalProperties":false},"taxRegistrationMessages":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"statusUpdateDetails":{"type":"object","properties":{"trackingNumber":{"type":"string","minLength":1},"statusCode":{"type":"string","minLength":1},"reasonCode":{"type":"string","minLength":1},"statusDateTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"statusLocationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","countryCode"],"additionalProperties":false},"shipmentSchedule":{"type":"object","properties":{"estimatedDeliveryDateTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"apptWindowStartDateTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"apptWindowEndDateTime":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"additionalProperties":false}},"required":["trackingNumber","statusCode","reasonCode","statusDateTime","statusLocationAddress"],"additionalProperties":false}},"required":["purchaseOrderNumber","sellingParty","shipFromParty","statusUpdateDetails"],"additionalProperties":false}}},"required":["shipmentStatusUpdates"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_PACKING_SLIP_GET","label":"Get direct fulfillment packing slip","group":"vendor-direct-fulfillment","entity":"Labels and packing slips","access":"READ","requiresPii":true,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Retrieve a Direct Fulfillment packing slip by purchase order number.","result":"Packing slip content.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"purchaseOrderNumbers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1}}},"required":["purchaseOrderNumbers"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_TRANSACTIONS_GET","label":"Get direct fulfillment transaction status","group":"vendor-direct-fulfillment","entity":"Transactions","access":"READ","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"Read the status of a Direct Fulfillment submit transaction.","result":"Transaction status.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transactionIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1}}},"required":["transactionIds"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_INVOICES_SUBMIT","label":"Submit direct fulfillment invoice","group":"vendor-direct-fulfillment","entity":"Invoices","access":"WRITE","requiresPii":false,"accountAvailability":"VENDORS_ONLY","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Submit a Direct Fulfillment invoice. Amazon returns a transaction id.","result":"Amazon transaction id.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"invoices":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"invoiceNumber":{"type":"string","minLength":1},"invoiceDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"taxPointDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"deliveryDate":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"referenceNumber":{"type":"string","minLength":1},"remitToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"billToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"billFromParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"vatGroupParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"taxRepresentativeParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipToParty":{"type":"object","properties":{"partyId":{"type":"string","minLength":1},"address":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationDetails":{"type":"array","items":{"type":"object","properties":{"taxRegistrationType":{"type":"string","enum":["VAT","GST","LocalTaxNumber"]},"taxRegistrationNumber":{"type":"string","minLength":1},"taxRegistrationAddress":{"type":"object","properties":{"name":{"type":"string","minLength":1},"addressLine1":{"type":"string","minLength":1},"addressLine2":{"type":"string","minLength":1},"addressLine3":{"type":"string","minLength":1},"city":{"type":"string","minLength":1},"county":{"type":"string","minLength":1},"district":{"type":"string","minLength":1},"stateOrRegion":{"type":"string","minLength":1},"postalCode":{"type":"string","minLength":1},"countryCode":{"type":"string","minLength":2,"maxLength":2},"phone":{"type":"string","minLength":1}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"additionalProperties":false},"taxRegistrationMessage":{"type":"string","minLength":1}},"required":["taxRegistrationNumber"],"additionalProperties":false}},"additionalPartyIdentifications":{"type":"array","items":{"type":"object","properties":{"identificationType":{"type":"string","enum":["FR_SIREN","DE_WIDNR"]},"identificationNumber":{"type":"string","minLength":1}},"required":["identificationType","identificationNumber"],"additionalProperties":false}}},"required":["partyId"],"additionalProperties":false},"shipToCountryCode":{"type":"string","minLength":2,"maxLength":2},"paymentTermsCode":{"type":"string","minLength":1},"invoiceTotal":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"invoiceBaseAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"exchangeRate":{"type":"string","minLength":1},"taxTotals":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}},"additionalDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["SUR","OCR","TaxExemptReason","LegalTerms","RegulatoryNote"]},"detail":{"type":"string","minLength":1},"languageCode":{"type":"string","minLength":1}},"required":["type","detail"],"additionalProperties":false}},"chargeDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["GIFTWRAP","FULFILLMENT","MARKETINGINSERT","PACKAGING","LOADING","FREIGHTOUT","TAX_COLLECTED_AT_SOURCE"]},"chargeAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","chargeAmount"],"additionalProperties":false}},"allowanceDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Discount","DiscountIncentive","Defective","Promotional","UnsaleableMerchandise","Special"]},"description":{"type":"string","minLength":1},"allowanceAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","allowanceAmount"],"additionalProperties":false}},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"itemSequenceNumber":{"type":"string","minLength":1},"buyerProductIdentifier":{"type":"string","minLength":1},"vendorProductIdentifier":{"type":"string","minLength":1},"itemDescription":{"type":"string","minLength":1},"invoicedQuantity":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"unitOfMeasure":{"type":"string","minLength":1}},"required":["amount","unitOfMeasure"],"additionalProperties":false},"netCost":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"purchaseOrderNumber":{"type":"string","minLength":1},"vendorOrderNumber":{"type":"string","minLength":1},"hsnCode":{"type":"string","minLength":1},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}},"additionalDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["SUR","OCR","TaxExemptReason","LegalTerms","RegulatoryNote"]},"detail":{"type":"string","minLength":1},"languageCode":{"type":"string","minLength":1}},"required":["type","detail"],"additionalProperties":false}},"chargeDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["GIFTWRAP","FULFILLMENT","MARKETINGINSERT","PACKAGING","LOADING","FREIGHTOUT","TAX_COLLECTED_AT_SOURCE"]},"chargeAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","chargeAmount"],"additionalProperties":false}},"allowanceDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Discount","DiscountIncentive","Defective","Promotional","UnsaleableMerchandise","Special"]},"description":{"type":"string","minLength":1},"allowanceAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxDetails":{"type":"array","items":{"type":"object","properties":{"taxType":{"type":"string","enum":["CGST","SGST","CESS","UTGST","IGST","MwSt.","PST","TVA","VAT","GST","ST","Consumption","MutuallyDefined","DomesticVAT"]},"taxRate":{"type":"string","minLength":1},"taxAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false},"taxableAmount":{"type":"object","properties":{"currencyCode":{"type":"string","minLength":3,"maxLength":3},"amount":{"type":"string","minLength":1}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["taxType","taxAmount"],"additionalProperties":false}}},"required":["type","allowanceAmount"],"additionalProperties":false}}},"required":["itemSequenceNumber","invoicedQuantity","netCost","purchaseOrderNumber"],"additionalProperties":false}}},"required":["invoiceNumber","invoiceDate","remitToParty","shipFromParty","invoiceTotal","items"],"additionalProperties":false}}},"required":["invoices"],"additionalProperties":false}},{"type":"AMAZON_VENDOR_DF_CUSTOMER_INVOICE_GET","label":"Get direct fulfillment customer invoice","group":"vendor-direct-fulfillment","entity":"Invoices","access":"READ","requiresPii":true,"accountAvailability":"VENDORS_ONLY","marketplaceNote":"India only.","maxItems":{"api":20,"mcp":10},"description":"Retrieve an India Direct Fulfillment customer invoice by purchase order number.","result":"Customer invoice file.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"purchaseOrderNumbers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1}}},"required":["purchaseOrderNumbers"],"additionalProperties":false}},{"type":"AMAZON_FINANCES_BALANCES_FIND","label":"Find Seller Central balances","group":"finances","entity":"Balances and payouts","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"List Seller Central balances. Filter by store, balance type, account type, and a past date. Omit the filters for the current balances. Each query returns one page of up to 500 balances.","result":"Balances with currency, amount, nested available and reserved amounts, and `lastUpdatedTime` or `asOfDate`.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"balanceQueries":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"marketplaceIds":{"description":"Amazon store ids. Omit this field to include every store Amazon returns for the connection region.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1}},"balanceType":{"description":"Balance type. Omit this field to include every balance type.","type":"string","enum":["AVAILABLE","RESERVED","TOTAL","DEFERRED","ACCOUNT_LEVEL_RESERVE"]},"accountType":{"description":"Account type, such as STANDARD_ORDERS or INVOICED_ORDERS. Omit this field to include every account type.","type":"string","minLength":1},"asOfDate":{"description":"Past balance date, such as 2026-10-01 for 1 October 2026. Omit this field for the current balance.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"nextToken":{"description":"nextToken from a previous response. Repeat the other query fields unchanged.","type":"string","minLength":1}},"additionalProperties":false}}},"required":["balanceQueries"],"additionalProperties":false,"description":"Reads Seller Central balances or payouts. Sellers only. Does not change the Amazon account. Lists balances via Finances API v2024-06-19 listBalances. Each query returns one page of up to 500 balances. A current balance includes lastUpdatedTime. A past balance includes asOfDate."}},{"type":"AMAZON_FINANCES_PAYOUTS_FIND","label":"Find Seller Central payouts","group":"finances","entity":"Balances and payouts","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"List Seller Central payouts by payout id, or by the time they were created. Set `createdAfter`, and set `createdBefore` only when it is later than `createdAfter`. Each query returns one page.","result":"Payouts with status, type, amount, payment method, and account tail.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payoutQueries":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"marketplaceIds":{"description":"Amazon store ids. Omit this field to include every store Amazon returns for the connection region.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1}},"createdAfter":{"description":"Include payouts created at or after this UTC date and time.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"createdBefore":{"description":"Include payouts created before this UTC date and time.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"payoutId":{"description":"Return only this payout.","type":"string","minLength":1},"accountType":{"description":"Account type, such as STANDARD_ORDERS or INVOICED_ORDERS. Omit this field to include every account type.","type":"string","minLength":1},"nextToken":{"description":"nextToken from a previous response. Repeat the other query fields unchanged.","type":"string","minLength":1}},"additionalProperties":false}}},"required":["payoutQueries"],"additionalProperties":false,"description":"Reads Seller Central balances or payouts. Sellers only. Does not change the Amazon account. Lists payouts via Transfers API v2024-06-01 listPayouts. Each query returns one page. Set payoutId, or set createdAfter."}},{"type":"AMAZON_FINANCES_EXPECTED_PAYOUTS_FIND","label":"Find expected Seller Central payouts","group":"finances","entity":"Balances and payouts","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_ONLY","marketplaceNote":null,"maxItems":{"api":20,"mcp":10},"description":"List upcoming Seller Central payouts. Filter by store and account type, or omit both filters. Each query returns one page.","result":"Expected payouts with status, amount, payment method, and `nextToken` when another page is available.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedPayoutQueries":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"marketplaceIds":{"description":"Amazon store ids. Omit this field to include every store Amazon returns for the connection region.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1}},"accountType":{"description":"Account type, such as STANDARD_ORDERS or INVOICED_ORDERS. Omit this field to include every account type.","type":"string","minLength":1},"nextToken":{"description":"nextToken from a previous response. Repeat the other query fields unchanged.","type":"string","minLength":1}},"additionalProperties":false}}},"required":["expectedPayoutQueries"],"additionalProperties":false,"description":"Reads Seller Central balances or payouts. Sellers only. Does not change the Amazon account. Lists upcoming payouts via Transfers API v2024-06-01 listExpectedPayouts. Each query returns one page."}},{"type":"AMAZON_ADS_CAMPAIGNS_ADD","label":"Add campaign","group":"ads-campaign-management","entity":"Campaigns","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads campaigns","result":"Created campaign entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"campaigns":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adomains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"autoCreationSettings":{"type":"object","properties":{"autoCreateTargets":{"description":"When true, Amazon creates an Auto targeting campaign. Same as targetingType=AUTO.","type":"boolean"},"autoManageCampaign":{"type":"boolean"}},"additionalProperties":false},"targetingType":{"description":"AUTO or MANUAL. AUTO sets autoCreateTargets=true. Omitted SPONSORED_PRODUCTS campaigns default to Manual.","type":"string","enum":["AUTO","MANUAL"]},"smartDefault":{"description":"Sponsored Brands Add only. MANUAL allows product and keyword targets. TARGETING applies theme targets and blocks product targets. When omitted, DataDoe sends MANUAL. Send one value, not a list. Amazon does not allow this value to change after the campaign is created. This is not bidStrategy and not targetingType.","type":"string","enum":["MANUAL","TARGETING"]},"brandId":{"description":"For SPONSORED_BRANDS ADD use the brand entity ID (starts with ENTITY, e.g. ENTITYHD7TBYRB5AJ1): AMAZON_ADS_BRANDS_FIND.brandEntityId, same value as AMAZON_ADS_CAMPAIGNS_FIND.brandId. Do not use the A… brandId from AMAZON_ADS_BRANDS_FIND. Required for sellers; optional for Vendor Central accounts. This is not campaignId.","type":"string","minLength":1,"maxLength":4096},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"costType":{"type":"string","enum":["CPC","CPM","FIXED_PRICE","VCPM"]},"countries":{"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","OTHER","OTHER_EEA","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","ZZ"]}},"endDateTime":{"type":"string","minLength":1,"maxLength":4096},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"flights":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"kpi":{"description":"Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpi. Required for SPONSORED_BRANDS ADD; only CLICKS is allowed (maps to SB v4 goal PAGE_VISIT). On UPDATE, supply the KPI explicitly; goal is not converted to KPI.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"description":"Optional Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpiValue. UPDATE accepts a value without kpi; null clears the value.","anyOf":[{"type":"number"},{"type":"null"}]},"goal":{"description":"FIND-only campaign goal (AWARENESS, CONSIDERATION, CONVERSIONS). On ADD, CONSIDERATION without kpi is coerced to kpi=CLICKS. For SPONSORED_BRANDS ADD that maps to SB v4 goal PAGE_VISIT. On UPDATE, an explicit kpi is required when goal is supplied; goal itself is not sent.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"goalSettings":{"description":"Alias for kpi and kpiValue in Amazon CREATE/UPDATE optimizations.goalSettings. Top-level fields take precedence. UPDATE supports either field independently; FIND-only goal requires an explicit kpi and is not sent.","type":"object","properties":{"goal":{"description":"FIND-only metadata, never sent to Amazon CREATE or UPDATE. UPDATE requires an explicit kpi when goal is supplied.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"kpi":{"type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"bidStrategy":{"description":"On ADD for SPONSORED_BRANDS, only MANUAL or SALES_UP_AND_DOWN. Omitted bidStrategy is treated as MANUAL. NEW_TO_BRAND appears on FIND but Amazon CREATE rejects it.","type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"placementBidAdjustments":{"description":"For SPONSORED_BRANDS ADD, HOME_PAGE maps to HOME, PRODUCT_PAGE to DETAIL_PAGE, REST_OF_SEARCH to OTHER. TOP_OF_SEARCH and SITE_AMAZON_BUSINESS are not supported.","maxItems":4,"type":"array","items":{"type":"object","properties":{"placement":{"type":"string","enum":["HOME_PAGE","PRODUCT_PAGE","REST_OF_BROWSE","REST_OF_SEARCH","SITE_AMAZON_BUSINESS","TOP_OF_BROWSE","TOP_OF_SEARCH"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"audienceBidAdjustments":{"description":"Audience bid boost for Sponsored Products and Sponsored Brands campaigns, one audience per campaign. On SPONSORED_BRANDS, set it with AMAZON_ADS_CAMPAIGNS_UPDATE after the campaign exists.","maxItems":1,"type":"array","items":{"type":"object","properties":{"audienceId":{"type":"string","minLength":1,"maxLength":4096,"description":"Audience to boost bids for. For an AMC audience, use the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND."},"percentage":{"type":"integer","minimum":0,"maximum":900,"description":"Bid increase in percent."}},"required":["audienceId","percentage"],"additionalProperties":false}},"creativeBidAdjustments":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"creativeType":{"type":"string","enum":["SPOTLIGHT"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"portfolioId":{"type":"string","minLength":1,"maxLength":4096},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"salesChannel":{"type":"string","enum":["AMAZON","OFF_AMAZON"]},"offAmazonBudgetControlStrategy":{"description":"Sponsored Products off-Amazon reach for ADD and UPDATE. MAXIMIZE_REACH maximizes reach off Amazon; MINIMIZE_SPEND limits reach to Amazon. Cannot be combined with siteRestrictions containing AMAZON_BUSINESS.","type":"string","enum":["MAXIMIZE_REACH","MINIMIZE_SPEND"]},"siteRestrictions":{"type":"array","items":{"type":"string","enum":["AMAZON_BUSINESS","AMAZON_HAUL"]}},"skanAppId":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetedPGDealId":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["campaigns"],"additionalProperties":false}},{"type":"AMAZON_ADS_CAMPAIGNS_UPDATE","label":"Update campaign","group":"ads-campaign-management","entity":"Campaigns","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads campaigns","result":"Full model of updated campaigns.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"campaigns":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adomains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"autoCreationSettings":{"type":"object","properties":{"autoCreateTargets":{"description":"When true, Amazon creates an Auto targeting campaign. Same as targetingType=AUTO.","type":"boolean"},"autoManageCampaign":{"type":"boolean"}},"additionalProperties":false},"targetingType":{"description":"AUTO or MANUAL. AUTO sets autoCreateTargets=true. Omitted SPONSORED_PRODUCTS campaigns default to Manual.","type":"string","enum":["AUTO","MANUAL"]},"smartDefault":{"description":"Sponsored Brands Add only. MANUAL allows product and keyword targets. TARGETING applies theme targets and blocks product targets. When omitted, DataDoe sends MANUAL. Send one value, not a list. Amazon does not allow this value to change after the campaign is created. This is not bidStrategy and not targetingType.","type":"string","enum":["MANUAL","TARGETING"]},"brandId":{"description":"For SPONSORED_BRANDS ADD use the brand entity ID (starts with ENTITY, e.g. ENTITYHD7TBYRB5AJ1): AMAZON_ADS_BRANDS_FIND.brandEntityId, same value as AMAZON_ADS_CAMPAIGNS_FIND.brandId. Do not use the A… brandId from AMAZON_ADS_BRANDS_FIND. Required for sellers; optional for Vendor Central accounts. This is not campaignId.","type":"string","minLength":1,"maxLength":4096},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"costType":{"type":"string","enum":["CPC","CPM","FIXED_PRICE","VCPM"]},"countries":{"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","OTHER","OTHER_EEA","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","ZZ"]}},"endDateTime":{"description":"Amazon Ads API v1 campaign end date. A date string sets the end date. null removes the end date. Omit the field to leave the current end date unchanged. An empty string is invalid.","anyOf":[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"flights":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"kpi":{"description":"Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpi. Required for SPONSORED_BRANDS ADD; only CLICKS is allowed (maps to SB v4 goal PAGE_VISIT). On UPDATE, supply the KPI explicitly; goal is not converted to KPI.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"description":"Optional Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpiValue. UPDATE accepts a value without kpi; null clears the value.","anyOf":[{"type":"number"},{"type":"null"}]},"goal":{"description":"FIND-only campaign goal (AWARENESS, CONSIDERATION, CONVERSIONS). On ADD, CONSIDERATION without kpi is coerced to kpi=CLICKS. For SPONSORED_BRANDS ADD that maps to SB v4 goal PAGE_VISIT. On UPDATE, an explicit kpi is required when goal is supplied; goal itself is not sent.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"goalSettings":{"description":"Alias for kpi and kpiValue in Amazon CREATE/UPDATE optimizations.goalSettings. Top-level fields take precedence. UPDATE supports either field independently; FIND-only goal requires an explicit kpi and is not sent.","type":"object","properties":{"goal":{"description":"FIND-only metadata, never sent to Amazon CREATE or UPDATE. UPDATE requires an explicit kpi when goal is supplied.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"kpi":{"type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"bidStrategy":{"description":"On ADD for SPONSORED_BRANDS, only MANUAL or SALES_UP_AND_DOWN. Omitted bidStrategy is treated as MANUAL. NEW_TO_BRAND appears on FIND but Amazon CREATE rejects it.","type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"placementBidAdjustments":{"description":"For SPONSORED_BRANDS ADD, HOME_PAGE maps to HOME, PRODUCT_PAGE to DETAIL_PAGE, REST_OF_SEARCH to OTHER. TOP_OF_SEARCH and SITE_AMAZON_BUSINESS are not supported.","maxItems":4,"type":"array","items":{"type":"object","properties":{"placement":{"type":"string","enum":["HOME_PAGE","PRODUCT_PAGE","REST_OF_BROWSE","REST_OF_SEARCH","SITE_AMAZON_BUSINESS","TOP_OF_BROWSE","TOP_OF_SEARCH"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"audienceBidAdjustments":{"description":"Audience bid boost for Sponsored Products and Sponsored Brands campaigns, one audience per campaign. On SPONSORED_BRANDS, set it with AMAZON_ADS_CAMPAIGNS_UPDATE after the campaign exists.","maxItems":1,"type":"array","items":{"type":"object","properties":{"audienceId":{"type":"string","minLength":1,"maxLength":4096,"description":"Audience to boost bids for. For an AMC audience, use the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND."},"percentage":{"type":"integer","minimum":0,"maximum":900,"description":"Bid increase in percent."}},"required":["audienceId","percentage"],"additionalProperties":false}},"creativeBidAdjustments":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"creativeType":{"type":"string","enum":["SPOTLIGHT"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"portfolioId":{"type":"string","minLength":1,"maxLength":4096},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"salesChannel":{"type":"string","enum":["AMAZON","OFF_AMAZON"]},"offAmazonBudgetControlStrategy":{"description":"Sponsored Products off-Amazon reach for ADD and UPDATE. MAXIMIZE_REACH maximizes reach off Amazon; MINIMIZE_SPEND limits reach to Amazon. Cannot be combined with siteRestrictions containing AMAZON_BUSINESS.","type":"string","enum":["MAXIMIZE_REACH","MINIMIZE_SPEND"]},"siteRestrictions":{"type":"array","items":{"type":"string","enum":["AMAZON_BUSINESS","AMAZON_HAUL"]}},"skanAppId":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetedPGDealId":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["campaigns"],"additionalProperties":false}},{"type":"AMAZON_ADS_CAMPAIGNS_REMOVE","label":"Remove campaign","group":"ads-campaign-management","entity":"Campaigns","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Remove Amazon Ads campaigns","result":"Empty response.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"campaigns":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adomains":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"autoCreationSettings":{"type":"object","properties":{"autoCreateTargets":{"description":"When true, Amazon creates an Auto targeting campaign. Same as targetingType=AUTO.","type":"boolean"},"autoManageCampaign":{"type":"boolean"}},"additionalProperties":false},"targetingType":{"description":"AUTO or MANUAL. AUTO sets autoCreateTargets=true. Omitted SPONSORED_PRODUCTS campaigns default to Manual.","type":"string","enum":["AUTO","MANUAL"]},"smartDefault":{"description":"Sponsored Brands Add only. MANUAL allows product and keyword targets. TARGETING applies theme targets and blocks product targets. When omitted, DataDoe sends MANUAL. Send one value, not a list. Amazon does not allow this value to change after the campaign is created. This is not bidStrategy and not targetingType.","type":"string","enum":["MANUAL","TARGETING"]},"brandId":{"description":"For SPONSORED_BRANDS ADD use the brand entity ID (starts with ENTITY, e.g. ENTITYHD7TBYRB5AJ1): AMAZON_ADS_BRANDS_FIND.brandEntityId, same value as AMAZON_ADS_CAMPAIGNS_FIND.brandId. Do not use the A… brandId from AMAZON_ADS_BRANDS_FIND. Required for sellers; optional for Vendor Central accounts. This is not campaignId.","type":"string","minLength":1,"maxLength":4096},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"costType":{"type":"string","enum":["CPC","CPM","FIXED_PRICE","VCPM"]},"countries":{"type":"array","items":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","OTHER","OTHER_EEA","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","ZZ"]}},"endDateTime":{"type":"string","minLength":1,"maxLength":4096},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"flights":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"kpi":{"description":"Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpi. Required for SPONSORED_BRANDS ADD; only CLICKS is allowed (maps to SB v4 goal PAGE_VISIT). On UPDATE, supply the KPI explicitly; goal is not converted to KPI.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"description":"Optional Amazon Ads API v1 CREATE/UPDATE optimizations.goalSettings.kpiValue. UPDATE accepts a value without kpi; null clears the value.","anyOf":[{"type":"number"},{"type":"null"}]},"goal":{"description":"FIND-only campaign goal (AWARENESS, CONSIDERATION, CONVERSIONS). On ADD, CONSIDERATION without kpi is coerced to kpi=CLICKS. For SPONSORED_BRANDS ADD that maps to SB v4 goal PAGE_VISIT. On UPDATE, an explicit kpi is required when goal is supplied; goal itself is not sent.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"goalSettings":{"description":"Alias for kpi and kpiValue in Amazon CREATE/UPDATE optimizations.goalSettings. Top-level fields take precedence. UPDATE supports either field independently; FIND-only goal requires an explicit kpi and is not sent.","type":"object","properties":{"goal":{"description":"FIND-only metadata, never sent to Amazon CREATE or UPDATE. UPDATE requires an explicit kpi when goal is supplied.","type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]},"kpi":{"type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]},"kpiValue":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"bidStrategy":{"description":"On ADD for SPONSORED_BRANDS, only MANUAL or SALES_UP_AND_DOWN. Omitted bidStrategy is treated as MANUAL. NEW_TO_BRAND appears on FIND but Amazon CREATE rejects it.","type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"placementBidAdjustments":{"description":"For SPONSORED_BRANDS ADD, HOME_PAGE maps to HOME, PRODUCT_PAGE to DETAIL_PAGE, REST_OF_SEARCH to OTHER. TOP_OF_SEARCH and SITE_AMAZON_BUSINESS are not supported.","maxItems":4,"type":"array","items":{"type":"object","properties":{"placement":{"type":"string","enum":["HOME_PAGE","PRODUCT_PAGE","REST_OF_BROWSE","REST_OF_SEARCH","SITE_AMAZON_BUSINESS","TOP_OF_BROWSE","TOP_OF_SEARCH"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"audienceBidAdjustments":{"description":"Audience bid boost for Sponsored Products and Sponsored Brands campaigns, one audience per campaign. On SPONSORED_BRANDS, set it with AMAZON_ADS_CAMPAIGNS_UPDATE after the campaign exists.","maxItems":1,"type":"array","items":{"type":"object","properties":{"audienceId":{"type":"string","minLength":1,"maxLength":4096,"description":"Audience to boost bids for. For an AMC audience, use the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND."},"percentage":{"type":"integer","minimum":0,"maximum":900,"description":"Bid increase in percent."}},"required":["audienceId","percentage"],"additionalProperties":false}},"creativeBidAdjustments":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"creativeType":{"type":"string","enum":["SPOTLIGHT"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"additionalProperties":false}},"portfolioId":{"type":"string","minLength":1,"maxLength":4096},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"salesChannel":{"type":"string","enum":["AMAZON","OFF_AMAZON"]},"offAmazonBudgetControlStrategy":{"description":"Sponsored Products off-Amazon reach for ADD and UPDATE. MAXIMIZE_REACH maximizes reach off Amazon; MINIMIZE_SPEND limits reach to Amazon. Cannot be combined with siteRestrictions containing AMAZON_BUSINESS.","type":"string","enum":["MAXIMIZE_REACH","MINIMIZE_SPEND"]},"siteRestrictions":{"type":"array","items":{"type":"string","enum":["AMAZON_BUSINESS","AMAZON_HAUL"]}},"skanAppId":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetedPGDealId":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["campaigns"],"additionalProperties":false}},{"type":"AMAZON_ADS_CAMPAIGNS_FIND","label":"Find campaigns","group":"ads-campaign-management","entity":"Campaigns","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads campaigns","result":"Full model of found campaigns.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"campaignQuery":{"type":"object","properties":{"adProductFilter":{"type":"object","properties":{"include":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"description":"Exactly one Amazon ad product type per FIND request. Query other product types in separate requests."}},"required":["include"],"additionalProperties":false},"campaignIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"goalFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]}}},"required":["include"],"additionalProperties":false},"marketplaceScopeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]}}},"required":["include"],"additionalProperties":false},"nameFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"portfolioIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"stateFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["ARCHIVED","DRAFT","ENABLED","PAUSED","PROPOSED"]}}},"required":["include"],"additionalProperties":false},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4130}},"required":["adProductFilter"],"additionalProperties":false}},"required":["campaignQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_GROUPS_ADD","label":"Add ad group","group":"ads-campaign-management","entity":"Ad groups","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads ad groups","result":"Created ad group entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adGroups":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"advertisedProductCategoryIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"baseBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"maxAverageBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"creativeRotationType":{"type":"string","enum":["RANDOM","WEIGHTED"]},"creativeType":{"type":"string","enum":["IMAGE","VIDEO"]},"endDateTime":{"type":"string","minLength":1,"maxLength":4096},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"inventoryType":{"type":"string","enum":["AAP_MOBILE_APP","ALEXA_DEVICES","ALL","AMAZON_MOBILE_DISPLAY","AUDIO","AUDIO_AMAZON_DEAL","DIGITAL_OUT_OF_HOME","DISPLAY","LIVE_EVENTS","MOBILE_DISPLAY","NATIVE","ONLINE_VIDEO","PODCAST","STANDARD_DISPLAY","STREAMING_TV","STREAMING_TV_AMAZON_DEAL","VIDEO"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"optimization":{"type":"object","properties":{"bidStrategy":{"type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"budgetSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"goalSettings":{"type":"object","properties":{"kpi":{"description":"For SPONSORED_DISPLAY: PURCHASES = conversions, CLICKS = page visits, REACH = viewable impressions.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]}},"additionalProperties":false}},"additionalProperties":false,"description":"Amazon Ads API v1 ad group optimization. Only bidStrategy, budgetSettings and goalSettings.kpi are accepted. For SPONSORED_DISPLAY, goalSettings.kpi is the ad group bid optimization: PURCHASES = optimize for conversions, CLICKS = optimize for page visits (Amazon default when omitted), REACH = optimize for viewable impressions. Set it on AMAZON_ADS_AD_GROUPS_ADD; Amazon may ignore a changed KPI on AMAZON_ADS_AD_GROUPS_UPDATE, so verify it with AMAZON_ADS_AD_GROUPS_FIND."},"pacing":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetingSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}},"required":["adGroups"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_GROUPS_UPDATE","label":"Update ad group","group":"ads-campaign-management","entity":"Ad groups","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads ad groups","result":"Full model of updated ad groups.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adGroups":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"advertisedProductCategoryIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"baseBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"maxAverageBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"creativeRotationType":{"type":"string","enum":["RANDOM","WEIGHTED"]},"creativeType":{"type":"string","enum":["IMAGE","VIDEO"]},"endDateTime":{"type":"string","minLength":1,"maxLength":4096},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"inventoryType":{"type":"string","enum":["AAP_MOBILE_APP","ALEXA_DEVICES","ALL","AMAZON_MOBILE_DISPLAY","AUDIO","AUDIO_AMAZON_DEAL","DIGITAL_OUT_OF_HOME","DISPLAY","LIVE_EVENTS","MOBILE_DISPLAY","NATIVE","ONLINE_VIDEO","PODCAST","STANDARD_DISPLAY","STREAMING_TV","STREAMING_TV_AMAZON_DEAL","VIDEO"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"optimization":{"type":"object","properties":{"bidStrategy":{"type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"budgetSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"goalSettings":{"type":"object","properties":{"kpi":{"description":"For SPONSORED_DISPLAY: PURCHASES = conversions, CLICKS = page visits, REACH = viewable impressions.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]}},"additionalProperties":false}},"additionalProperties":false,"description":"Amazon Ads API v1 ad group optimization. Only bidStrategy, budgetSettings and goalSettings.kpi are accepted. For SPONSORED_DISPLAY, goalSettings.kpi is the ad group bid optimization: PURCHASES = optimize for conversions, CLICKS = optimize for page visits (Amazon default when omitted), REACH = optimize for viewable impressions. Set it on AMAZON_ADS_AD_GROUPS_ADD; Amazon may ignore a changed KPI on AMAZON_ADS_AD_GROUPS_UPDATE, so verify it with AMAZON_ADS_AD_GROUPS_FIND."},"pacing":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetingSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}},"required":["adGroups"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_GROUPS_REMOVE","label":"Remove ad group","group":"ads-campaign-management","entity":"Ad groups","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Remove Amazon Ads ad groups","result":"Empty response.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adGroups":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"adSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"advertisedProductCategoryIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"baseBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"maxAverageBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"budgets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"creativeRotationType":{"type":"string","enum":["RANDOM","WEIGHTED"]},"creativeType":{"type":"string","enum":["IMAGE","VIDEO"]},"endDateTime":{"type":"string","minLength":1,"maxLength":4096},"fees":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"frequencies":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"inventoryType":{"type":"string","enum":["AAP_MOBILE_APP","ALEXA_DEVICES","ALL","AMAZON_MOBILE_DISPLAY","AUDIO","AUDIO_AMAZON_DEAL","DIGITAL_OUT_OF_HOME","DISPLAY","LIVE_EVENTS","MOBILE_DISPLAY","NATIVE","ONLINE_VIDEO","PODCAST","STANDARD_DISPLAY","STREAMING_TV","STREAMING_TV_AMAZON_DEAL","VIDEO"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"optimization":{"type":"object","properties":{"bidStrategy":{"type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"]},"budgetSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"goalSettings":{"type":"object","properties":{"kpi":{"description":"For SPONSORED_DISPLAY: PURCHASES = conversions, CLICKS = page visits, REACH = viewable impressions.","type":"string","enum":["ADD_TO_CART","APPLICATIONS","CHECKOUTS","CLICKS","CLICK_THROUGH_RATE","COMBINED_RETURN_ON_AD_SPEND","CONTACTS","COST_PER_ACTION","COST_PER_CLICK","COST_PER_CONVERSION_OFF_AMAZON","COST_PER_DETAIL_PAGE_VIEW","COST_PER_FIRST_APP_OPEN","COST_PER_INSTALL","COST_PER_SIGN_UP","COST_PER_UNSKIPPED_IMPRESSION","COST_PER_VIDEO_COMPLETION","DETAIL_PAGE_VIEW_RATE","FREQUENCY_AVERAGE","LEADS","NEW_TO_BRAND_PURCHASES","OTHER","PAGE_VIEWS","PURCHASES","REACH","RETURN_ON_AD_SPEND","ROAS","ROAS_COMBINED","ROAS_OFF_AMAZON","ROAS_PROMOTED","SEARCH","SIGN_UP","SUBSCRIBE","TOP_OF_SEARCH_IMPRESSION_SHARE","TOTAL_RETURN_ON_AD_SPEND","VIDEO_COMPLETION_RATE"]}},"additionalProperties":false}},"additionalProperties":false,"description":"Amazon Ads API v1 ad group optimization. Only bidStrategy, budgetSettings and goalSettings.kpi are accepted. For SPONSORED_DISPLAY, goalSettings.kpi is the ad group bid optimization: PURCHASES = optimize for conversions, CLICKS = optimize for page visits (Amazon default when omitted), REACH = optimize for viewable impressions. Set it on AMAZON_ADS_AD_GROUPS_ADD; Amazon may ignore a changed KPI on AMAZON_ADS_AD_GROUPS_UPDATE, so verify it with AMAZON_ADS_AD_GROUPS_FIND."},"pacing":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"purchaseOrderNumber":{"type":"string","minLength":1,"maxLength":4096},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}},"targetingSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}},"required":["adGroups"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_GROUPS_FIND","label":"Find ad groups","group":"ads-campaign-management","entity":"Ad groups","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads ad groups","result":"Full model of found ad groups.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adGroupQuery":{"type":"object","properties":{"adGroupIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adProductFilter":{"type":"object","properties":{"include":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"description":"Exactly one Amazon ad product type per FIND request. Query other product types in separate requests."}},"required":["include"],"additionalProperties":false},"campaignIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"marketplaceScopeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]}}},"required":["include"],"additionalProperties":false},"nameFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"stateFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["ARCHIVED","DRAFT","ENABLED","PAUSED","PROPOSED"]}}},"required":["include"],"additionalProperties":false},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4130}},"required":["adProductFilter"],"additionalProperties":false}},"required":["adGroupQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_TARGETS_ADD","label":"Add target","group":"ads-campaign-management","entity":"Targets","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads targets","result":"Created target entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targets":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string","minLength":1,"maxLength":128},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"negative":{"type":"boolean"},"targetType":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","SKIPPABILITY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"]},"targetDetails":{"description":"Amazon Ads API v1 CreateTargetDetails with exactly one wrapper key matching targetType. Flat inner fields are also accepted when targetType is set.","anyOf":[{"type":"object","properties":{"keywordTarget":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"matchType":{"type":"string","enum":["BROAD","EXACT","PHRASE"]},"nativeLanguageKeyword":{"type":"string","minLength":1},"nativeLanguageLocale":{"type":"string","enum":["aa_ET","ab_GE","ae_INT","af_ZA","ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","az_AZ","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bn_BD","bo_CN","br_FR","bs_BA","ca_ES","ce_RU","ch_GU","co_FR","cr_CA","cs_CZ","cu_INT","cv_RU","cy_GB","da_DK","de_DE","dv_MV","dz_BT","ee_GH","el_GR","en_US","eo_INT","es_ES","et_EE","eu_ES","fa_IR","ff_SN","fi_FI","fj_FJ","fo_FO","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","iw_IL","ja_JP","ji_IL","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mo_MD","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zu_ZA"]}},"required":["keyword","matchType"],"additionalProperties":false}},"required":["keywordTarget"],"additionalProperties":false,"description":"Keyword target. For negative keywords set item.negative=true and use matchType EXACT or PHRASE. There is no NEGATIVE_EXACT match type."},{"type":"object","properties":{"productTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["PRODUCT_COMPLEMENTS","PRODUCT_EXACT","PRODUCT_REMARKETING","PRODUCT_SIMILAR"]},"product":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productId":{"type":"string","minLength":1}},"required":["marketplace","productId"],"additionalProperties":false}},"productId":{"type":"string","minLength":1}},"additionalProperties":false},"productIdType":{"type":"string","enum":["ASIN","RETAILER_OFFER","SKU"]}},"required":["matchType","product","productIdType"],"additionalProperties":false}},"required":["productTarget"],"additionalProperties":false,"description":"Product (ASIN or SKU) target. Negative ASIN: item.negative=true, matchType=PRODUCT_EXACT, productIdType=ASIN, product.productId=<ASIN>. PRODUCT_EXACT corresponds to SP v3 ASIN_SAME_AS, PRODUCT_SIMILAR to ASIN_EXPANDED_FROM. Campaign-level negatives use campaignId instead of adGroupId."},{"type":"object","properties":{"productCategoryTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["MULTISIGNAL_BROAD"]},"productCategoryRefinement":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"required":["marketplace","productCategoryRefinement"],"additionalProperties":false}},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"productGenreRefinement":{"type":"object","properties":{"productGenreId":{"type":"string","minLength":1}},"required":["productGenreId"],"additionalProperties":false}},"required":["productCategoryRefinement"],"additionalProperties":false}},"required":["productCategoryTarget"],"additionalProperties":false,"description":"Category or brand target (SP v3 ASIN_CATEGORY_SAME_AS / ASIN_BRAND_SAME_AS). Use productCategoryTarget.productCategoryRefinement.productCategoryRefinement.productCategoryId and/or productBrandId."},{"type":"object","properties":{"themeTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["INTERESTED_AUDIENCE","KEYWORDS_CLOSE_MATCH","KEYWORDS_LOOSE_MATCH","KEYWORDS_RELATED_TO_GIFTS","KEYWORDS_RELATED_TO_PEER_BRANDS_PRODUCT_CATEGORY","KEYWORDS_RELATED_TO_PRIME_DAY","KEYWORDS_RELATED_TO_YOUR_BRAND","KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES","KEYWORDS_RELATED_TO_YOUR_PRODUCT_CATEGORY","PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS","PRODUCT_COMPLEMENTS","PRODUCT_SUBSTITUTES"]}},"required":["matchType"],"additionalProperties":false}},"required":["themeTarget"],"additionalProperties":false,"description":"Auto-targeting theme target (Sponsored Products auto campaigns). Amazon creates the four SP Auto theme targets with every Auto ad group, so AMAZON_ADS_TARGETS_ADD rejects positive SP THEME targets; use AMAZON_ADS_TARGETS_FIND and AMAZON_ADS_TARGETS_UPDATE instead."},{"type":"object","properties":{"locationTarget":{"type":"object","properties":{"locationId":{"type":"string","minLength":1},"locationIdResolved":{"type":"string","minLength":1}},"required":["locationId"],"additionalProperties":false}},"required":["locationTarget"],"additionalProperties":false,"description":"Location target."},{"type":"object","properties":{"audienceTarget":{"type":"object","properties":{"acrossGroupOperator":{"type":"string","enum":["ALL","ANY"]},"audienceId":{"type":"object","properties":{"defaultValue":{"type":"string","minLength":1}},"additionalProperties":false},"groupId":{"type":"string","minLength":1},"inGroupOperator":{"type":"string","enum":["ALL","ANY"]}},"required":["audienceId"],"additionalProperties":false}},"required":["audienceTarget"],"additionalProperties":false,"description":"Audience target for Sponsored Display (targetType AUDIENCE). For an AMC audience, set audienceTarget.audienceId.defaultValue to the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND with adProduct SPONSORED_DISPLAY."},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Any other Amazon Ads API v1 CreateTargetDetails wrapper (dayPartTarget, ...) for Sponsored Brands, Sponsored Display or DSP. Exactly one wrapper key."}]},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["targets"],"additionalProperties":false}},{"type":"AMAZON_ADS_TARGETS_UPDATE","label":"Update target","group":"ads-campaign-management","entity":"Targets","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads targets","result":"Full model of updated targets.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targets":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string","minLength":1,"maxLength":128},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"negative":{"type":"boolean"},"targetType":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","SKIPPABILITY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"]},"targetDetails":{"description":"Amazon Ads API v1 CreateTargetDetails with exactly one wrapper key matching targetType. Flat inner fields are also accepted when targetType is set.","anyOf":[{"type":"object","properties":{"keywordTarget":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"matchType":{"type":"string","enum":["BROAD","EXACT","PHRASE"]},"nativeLanguageKeyword":{"type":"string","minLength":1},"nativeLanguageLocale":{"type":"string","enum":["aa_ET","ab_GE","ae_INT","af_ZA","ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","az_AZ","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bn_BD","bo_CN","br_FR","bs_BA","ca_ES","ce_RU","ch_GU","co_FR","cr_CA","cs_CZ","cu_INT","cv_RU","cy_GB","da_DK","de_DE","dv_MV","dz_BT","ee_GH","el_GR","en_US","eo_INT","es_ES","et_EE","eu_ES","fa_IR","ff_SN","fi_FI","fj_FJ","fo_FO","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","iw_IL","ja_JP","ji_IL","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mo_MD","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zu_ZA"]}},"required":["keyword","matchType"],"additionalProperties":false}},"required":["keywordTarget"],"additionalProperties":false,"description":"Keyword target. For negative keywords set item.negative=true and use matchType EXACT or PHRASE. There is no NEGATIVE_EXACT match type."},{"type":"object","properties":{"productTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["PRODUCT_COMPLEMENTS","PRODUCT_EXACT","PRODUCT_REMARKETING","PRODUCT_SIMILAR"]},"product":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productId":{"type":"string","minLength":1}},"required":["marketplace","productId"],"additionalProperties":false}},"productId":{"type":"string","minLength":1}},"additionalProperties":false},"productIdType":{"type":"string","enum":["ASIN","RETAILER_OFFER","SKU"]}},"required":["matchType","product","productIdType"],"additionalProperties":false}},"required":["productTarget"],"additionalProperties":false,"description":"Product (ASIN or SKU) target. Negative ASIN: item.negative=true, matchType=PRODUCT_EXACT, productIdType=ASIN, product.productId=<ASIN>. PRODUCT_EXACT corresponds to SP v3 ASIN_SAME_AS, PRODUCT_SIMILAR to ASIN_EXPANDED_FROM. Campaign-level negatives use campaignId instead of adGroupId."},{"type":"object","properties":{"productCategoryTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["MULTISIGNAL_BROAD"]},"productCategoryRefinement":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"required":["marketplace","productCategoryRefinement"],"additionalProperties":false}},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"productGenreRefinement":{"type":"object","properties":{"productGenreId":{"type":"string","minLength":1}},"required":["productGenreId"],"additionalProperties":false}},"required":["productCategoryRefinement"],"additionalProperties":false}},"required":["productCategoryTarget"],"additionalProperties":false,"description":"Category or brand target (SP v3 ASIN_CATEGORY_SAME_AS / ASIN_BRAND_SAME_AS). Use productCategoryTarget.productCategoryRefinement.productCategoryRefinement.productCategoryId and/or productBrandId."},{"type":"object","properties":{"themeTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["INTERESTED_AUDIENCE","KEYWORDS_CLOSE_MATCH","KEYWORDS_LOOSE_MATCH","KEYWORDS_RELATED_TO_GIFTS","KEYWORDS_RELATED_TO_PEER_BRANDS_PRODUCT_CATEGORY","KEYWORDS_RELATED_TO_PRIME_DAY","KEYWORDS_RELATED_TO_YOUR_BRAND","KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES","KEYWORDS_RELATED_TO_YOUR_PRODUCT_CATEGORY","PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS","PRODUCT_COMPLEMENTS","PRODUCT_SUBSTITUTES"]}},"required":["matchType"],"additionalProperties":false}},"required":["themeTarget"],"additionalProperties":false,"description":"Auto-targeting theme target (Sponsored Products auto campaigns). Amazon creates the four SP Auto theme targets with every Auto ad group, so AMAZON_ADS_TARGETS_ADD rejects positive SP THEME targets; use AMAZON_ADS_TARGETS_FIND and AMAZON_ADS_TARGETS_UPDATE instead."},{"type":"object","properties":{"locationTarget":{"type":"object","properties":{"locationId":{"type":"string","minLength":1},"locationIdResolved":{"type":"string","minLength":1}},"required":["locationId"],"additionalProperties":false}},"required":["locationTarget"],"additionalProperties":false,"description":"Location target."},{"type":"object","properties":{"audienceTarget":{"type":"object","properties":{"acrossGroupOperator":{"type":"string","enum":["ALL","ANY"]},"audienceId":{"type":"object","properties":{"defaultValue":{"type":"string","minLength":1}},"additionalProperties":false},"groupId":{"type":"string","minLength":1},"inGroupOperator":{"type":"string","enum":["ALL","ANY"]}},"required":["audienceId"],"additionalProperties":false}},"required":["audienceTarget"],"additionalProperties":false,"description":"Audience target for Sponsored Display (targetType AUDIENCE). For an AMC audience, set audienceTarget.audienceId.defaultValue to the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND with adProduct SPONSORED_DISPLAY."},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Any other Amazon Ads API v1 CreateTargetDetails wrapper (dayPartTarget, ...) for Sponsored Brands, Sponsored Display or DSP. Exactly one wrapper key."}]},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["targets"],"additionalProperties":false}},{"type":"AMAZON_ADS_TARGETS_REMOVE","label":"Remove target","group":"ads-campaign-management","entity":"Targets","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Remove Amazon Ads targets","result":"Empty response.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targets":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string","minLength":1,"maxLength":128},"campaignId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"negative":{"type":"boolean"},"targetType":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","SKIPPABILITY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"]},"targetDetails":{"description":"Amazon Ads API v1 CreateTargetDetails with exactly one wrapper key matching targetType. Flat inner fields are also accepted when targetType is set.","anyOf":[{"type":"object","properties":{"keywordTarget":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"matchType":{"type":"string","enum":["BROAD","EXACT","PHRASE"]},"nativeLanguageKeyword":{"type":"string","minLength":1},"nativeLanguageLocale":{"type":"string","enum":["aa_ET","ab_GE","ae_INT","af_ZA","ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","az_AZ","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bn_BD","bo_CN","br_FR","bs_BA","ca_ES","ce_RU","ch_GU","co_FR","cr_CA","cs_CZ","cu_INT","cv_RU","cy_GB","da_DK","de_DE","dv_MV","dz_BT","ee_GH","el_GR","en_US","eo_INT","es_ES","et_EE","eu_ES","fa_IR","ff_SN","fi_FI","fj_FJ","fo_FO","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","iw_IL","ja_JP","ji_IL","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mo_MD","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zu_ZA"]}},"required":["keyword","matchType"],"additionalProperties":false}},"required":["keywordTarget"],"additionalProperties":false,"description":"Keyword target. For negative keywords set item.negative=true and use matchType EXACT or PHRASE. There is no NEGATIVE_EXACT match type."},{"type":"object","properties":{"productTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["PRODUCT_COMPLEMENTS","PRODUCT_EXACT","PRODUCT_REMARKETING","PRODUCT_SIMILAR"]},"product":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productId":{"type":"string","minLength":1}},"required":["marketplace","productId"],"additionalProperties":false}},"productId":{"type":"string","minLength":1}},"additionalProperties":false},"productIdType":{"type":"string","enum":["ASIN","RETAILER_OFFER","SKU"]}},"required":["matchType","product","productIdType"],"additionalProperties":false}},"required":["productTarget"],"additionalProperties":false,"description":"Product (ASIN or SKU) target. Negative ASIN: item.negative=true, matchType=PRODUCT_EXACT, productIdType=ASIN, product.productId=<ASIN>. PRODUCT_EXACT corresponds to SP v3 ASIN_SAME_AS, PRODUCT_SIMILAR to ASIN_EXPANDED_FROM. Campaign-level negatives use campaignId instead of adGroupId."},{"type":"object","properties":{"productCategoryTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["MULTISIGNAL_BROAD"]},"productCategoryRefinement":{"type":"object","properties":{"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"required":["marketplace","productCategoryRefinement"],"additionalProperties":false}},"productCategoryRefinement":{"type":"object","properties":{"productAgeRangeId":{"type":"string","minLength":1},"productAgeRangeIdResolved":{"type":"string","minLength":1},"productBrandId":{"type":"string","minLength":1},"productBrandIdResolved":{"type":"string","minLength":1},"productCategoryId":{"type":"string","minLength":1},"productCategoryIdResolved":{"type":"string","minLength":1},"productGenreId":{"type":"string","minLength":1},"productPriceGreaterThan":{"type":"number"},"productPriceLessThan":{"type":"number"},"productPrimeShippingEligible":{"type":"boolean"},"productRatingGreaterThan":{"type":"number"},"productRatingLessThan":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"productGenreRefinement":{"type":"object","properties":{"productGenreId":{"type":"string","minLength":1}},"required":["productGenreId"],"additionalProperties":false}},"required":["productCategoryRefinement"],"additionalProperties":false}},"required":["productCategoryTarget"],"additionalProperties":false,"description":"Category or brand target (SP v3 ASIN_CATEGORY_SAME_AS / ASIN_BRAND_SAME_AS). Use productCategoryTarget.productCategoryRefinement.productCategoryRefinement.productCategoryId and/or productBrandId."},{"type":"object","properties":{"themeTarget":{"type":"object","properties":{"matchType":{"type":"string","enum":["INTERESTED_AUDIENCE","KEYWORDS_CLOSE_MATCH","KEYWORDS_LOOSE_MATCH","KEYWORDS_RELATED_TO_GIFTS","KEYWORDS_RELATED_TO_PEER_BRANDS_PRODUCT_CATEGORY","KEYWORDS_RELATED_TO_PRIME_DAY","KEYWORDS_RELATED_TO_YOUR_BRAND","KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES","KEYWORDS_RELATED_TO_YOUR_PRODUCT_CATEGORY","PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS","PRODUCT_COMPLEMENTS","PRODUCT_SUBSTITUTES"]}},"required":["matchType"],"additionalProperties":false}},"required":["themeTarget"],"additionalProperties":false,"description":"Auto-targeting theme target (Sponsored Products auto campaigns). Amazon creates the four SP Auto theme targets with every Auto ad group, so AMAZON_ADS_TARGETS_ADD rejects positive SP THEME targets; use AMAZON_ADS_TARGETS_FIND and AMAZON_ADS_TARGETS_UPDATE instead."},{"type":"object","properties":{"locationTarget":{"type":"object","properties":{"locationId":{"type":"string","minLength":1},"locationIdResolved":{"type":"string","minLength":1}},"required":["locationId"],"additionalProperties":false}},"required":["locationTarget"],"additionalProperties":false,"description":"Location target."},{"type":"object","properties":{"audienceTarget":{"type":"object","properties":{"acrossGroupOperator":{"type":"string","enum":["ALL","ANY"]},"audienceId":{"type":"object","properties":{"defaultValue":{"type":"string","minLength":1}},"additionalProperties":false},"groupId":{"type":"string","minLength":1},"inGroupOperator":{"type":"string","enum":["ALL","ANY"]}},"required":["audienceId"],"additionalProperties":false}},"required":["audienceTarget"],"additionalProperties":false,"description":"Audience target for Sponsored Display (targetType AUDIENCE). For an AMC audience, set audienceTarget.audienceId.defaultValue to the audienceId from AMAZON_ADS_TARGETABLE_AUDIENCES_FIND with adProduct SPONSORED_DISPLAY."},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Any other Amazon Ads API v1 CreateTargetDetails wrapper (dayPartTarget, ...) for Sponsored Brands, Sponsored Display or DSP. Exactly one wrapper key."}]},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"marketplaceSettings":{"type":"array","items":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"bid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99},"defaultBid":{"type":"number","exclusiveMinimum":0,"maximum":999999999.99}},"additionalProperties":false}},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["targets"],"additionalProperties":false}},{"type":"AMAZON_ADS_TARGETS_FIND","label":"Find targets","group":"ads-campaign-management","entity":"Targets","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads targets","result":"Full model of found targets.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targetQuery":{"type":"object","properties":{"adGroupIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adProductFilter":{"type":"object","properties":{"include":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"description":"Exactly one Amazon ad product type per FIND request. Query other product types in separate requests."}},"required":["include"],"additionalProperties":false},"campaignIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"inventorySourceIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"object","properties":{"defaultValue":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["include"],"additionalProperties":false},"inventorySourceTypeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["AMAZON","APD","DEAL","INVENTORY_GROUP","THIRD_PARTY_EXCHANGE"]}}},"required":["include"],"additionalProperties":false},"keywordFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"marketplaceScopeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]}}},"required":["include"],"additionalProperties":false},"matchTypeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["BROAD","EXACT","INTERESTED_AUDIENCE","KEYWORDS_CLOSE_MATCH","KEYWORDS_LOOSE_MATCH","KEYWORDS_RELATED_TO_GIFTS","KEYWORDS_RELATED_TO_PEER_BRANDS_PRODUCT_CATEGORY","KEYWORDS_RELATED_TO_PRIME_DAY","KEYWORDS_RELATED_TO_YOUR_BRAND","KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES","KEYWORDS_RELATED_TO_YOUR_PRODUCT_CATEGORY","PHRASE","PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS","PRODUCT_COMPLEMENTS","PRODUCT_EXACT","PRODUCT_REMARKETING","PRODUCT_SIMILAR","PRODUCT_SUBSTITUTES"]}}},"required":["include"],"additionalProperties":false},"nativeLanguageLocaleFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["aa_ET","ab_GE","ae_INT","af_ZA","ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","az_AZ","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bn_BD","bo_CN","br_FR","bs_BA","ca_ES","ce_RU","ch_GU","co_FR","cr_CA","cs_CZ","cu_INT","cv_RU","cy_GB","da_DK","de_DE","dv_MV","dz_BT","ee_GH","el_GR","en_US","eo_INT","es_ES","et_EE","eu_ES","fa_IR","ff_SN","fi_FI","fj_FJ","fo_FO","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","iw_IL","ja_JP","ji_IL","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mo_MD","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zu_ZA"]}}},"required":["include"],"additionalProperties":false},"negativeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"boolean"}}},"required":["include"],"additionalProperties":false},"productIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"stateFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["ARCHIVED","DRAFT","ENABLED","PAUSED","PROPOSED"]}}},"required":["include"],"additionalProperties":false},"targetIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"targetTypeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","SKIPPABILITY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"]}}},"required":["include"],"additionalProperties":false},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4130}},"required":["adProductFilter"],"additionalProperties":false}},"required":["targetQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_ADS_ADD","label":"Add ad","group":"ads-campaign-management","entity":"Ads","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads ads","result":"Created ad entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ads":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"description":"Ad product. Required on add. Optional on update and remove: when omitted, DataDoe looks it up by adId. Passing it skips the lookup.","type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"adType":{"type":"string","enum":["AUDIO","COMPONENT","DISPLAY","PRODUCT_AD","THIRD_PARTY","VIDEO"]},"creative":{"description":"For SP product ads, productIdType=ASIN is resolved to SKU automatically for Seller Central accounts using synced listings data. Vendor Central accounts may use ASIN directly. For SPONSORED_BRANDS (adType=COMPONENT) use exactly one of componentCreative.productCollectionSettings or componentCreative.productVideoSettings (other SB formats are not supported). Product collection ads are created as Manual Collection ads: brand of at most 30 characters, at most one brandLogos entry, at most one headline of at most 32 characters (sent as the title), 3-10 product ASINs, landingPage STORE (with a Store landingPageUrl) or ASIN_LIST (the product ASINs; a Store URL makes it a Store landing page); customImages, CUSTOM_URL landing pages and creativePropertiesToOptimize are not supported. Video: exactly one videos entry and one product ASIN; the ad lands on the product detail page. SPONSORED_BRANDS ad updates accept only name and state, not creative. SPONSORED_DISPLAY ads require adType=COMPONENT and exactly one product: creative.sku, creative.asin, or creative.componentCreative.responsiveEcommerceSettings.products[0] with productId and productIdType (send one ad item per product). They are created as Sponsored Display product ads, so custom creative settings (logos, headlines, images, assetBasedCreativeSettings) are not supported; sellers advertise SKUs (ASIN is resolved to SKU for Seller Central accounts), vendors advertise ASINs. They do not accept marketplaces, marketplaceScope, marketplaceConfigurations or product marketplaceSettings (the marketplace comes from the Ads profile).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["ads"],"additionalProperties":false}},{"type":"AMAZON_ADS_ADS_UPDATE","label":"Update ad","group":"ads-campaign-management","entity":"Ads","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads ads","result":"Full model of updated ads.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ads":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"description":"Ad product. Required on add. Optional on update and remove: when omitted, DataDoe looks it up by adId. Passing it skips the lookup.","type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"adType":{"type":"string","enum":["AUDIO","COMPONENT","DISPLAY","PRODUCT_AD","THIRD_PARTY","VIDEO"]},"creative":{"description":"For SP product ads, productIdType=ASIN is resolved to SKU automatically for Seller Central accounts using synced listings data. Vendor Central accounts may use ASIN directly. For SPONSORED_BRANDS (adType=COMPONENT) use exactly one of componentCreative.productCollectionSettings or componentCreative.productVideoSettings (other SB formats are not supported). Product collection ads are created as Manual Collection ads: brand of at most 30 characters, at most one brandLogos entry, at most one headline of at most 32 characters (sent as the title), 3-10 product ASINs, landingPage STORE (with a Store landingPageUrl) or ASIN_LIST (the product ASINs; a Store URL makes it a Store landing page); customImages, CUSTOM_URL landing pages and creativePropertiesToOptimize are not supported. Video: exactly one videos entry and one product ASIN; the ad lands on the product detail page. SPONSORED_BRANDS ad updates accept only name and state, not creative. SPONSORED_DISPLAY ads require adType=COMPONENT and exactly one product: creative.sku, creative.asin, or creative.componentCreative.responsiveEcommerceSettings.products[0] with productId and productIdType (send one ad item per product). They are created as Sponsored Display product ads, so custom creative settings (logos, headlines, images, assetBasedCreativeSettings) are not supported; sellers advertise SKUs (ASIN is resolved to SKU for Seller Central accounts), vendors advertise ASINs. They do not accept marketplaces, marketplaceScope, marketplaceConfigurations or product marketplaceSettings (the marketplace comes from the Ads profile).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["ads"],"additionalProperties":false}},{"type":"AMAZON_ADS_ADS_REMOVE","label":"Remove ad","group":"ads-campaign-management","entity":"Ads","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Remove Amazon Ads ads","result":"Empty response.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ads":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adProduct":{"description":"Ad product. Required on add. Optional on update and remove: when omitted, DataDoe looks it up by adId. Passing it skips the lookup.","type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"adType":{"type":"string","enum":["AUDIO","COMPONENT","DISPLAY","PRODUCT_AD","THIRD_PARTY","VIDEO"]},"creative":{"description":"For SP product ads, productIdType=ASIN is resolved to SKU automatically for Seller Central accounts using synced listings data. Vendor Central accounts may use ASIN directly. For SPONSORED_BRANDS (adType=COMPONENT) use exactly one of componentCreative.productCollectionSettings or componentCreative.productVideoSettings (other SB formats are not supported). Product collection ads are created as Manual Collection ads: brand of at most 30 characters, at most one brandLogos entry, at most one headline of at most 32 characters (sent as the title), 3-10 product ASINs, landingPage STORE (with a Store landingPageUrl) or ASIN_LIST (the product ASINs; a Store URL makes it a Store landing page); customImages, CUSTOM_URL landing pages and creativePropertiesToOptimize are not supported. Video: exactly one videos entry and one product ASIN; the ad lands on the product detail page. SPONSORED_BRANDS ad updates accept only name and state, not creative. SPONSORED_DISPLAY ads require adType=COMPONENT and exactly one product: creative.sku, creative.asin, or creative.componentCreative.responsiveEcommerceSettings.products[0] with productId and productIdType (send one ad item per product). They are created as Sponsored Display product ads, so custom creative settings (logos, headlines, images, assetBasedCreativeSettings) are not supported; sellers advertise SKUs (ASIN is resolved to SKU for Seller Central accounts), vendors advertise ASINs. They do not accept marketplaces, marketplaceScope, marketplaceConfigurations or product marketplaceSettings (the marketplace comes from the Ads profile).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"marketplaceConfigurations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]},"marketplaces":{"type":"array","items":{"type":"string","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":256}},"required":["key","value"],"additionalProperties":false}}},"additionalProperties":false}}},"required":["ads"],"additionalProperties":false}},{"type":"AMAZON_ADS_ADS_FIND","label":"Find ads","group":"ads-campaign-management","entity":"Ads","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads ads","result":"Full model of found ads.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adQuery":{"type":"object","properties":{"adGroupIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adProductFilter":{"type":"object","properties":{"include":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"string","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]},"description":"Exactly one Amazon ad product type per FIND request. Query other product types in separate requests."}},"required":["include"],"additionalProperties":false},"campaignIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"marketplaceScopeFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]}}},"required":["include"],"additionalProperties":false},"nameFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"stateFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["ARCHIVED","DRAFT","ENABLED","PAUSED","PROPOSED"]}}},"required":["include"],"additionalProperties":false},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4130}},"required":["adProductFilter"],"additionalProperties":false}},"required":["adQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_ASSOCIATIONS_ADD","label":"Add ad association","group":"ads-campaign-management","entity":"Ad associations","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads ad associations","result":"Created ad association entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adAssociations":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adAssociationId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adId":{"type":"string","minLength":1,"maxLength":4096},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"weight":{"type":"number","minimum":0,"maximum":100},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"endDateTime":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["adAssociations"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_ASSOCIATIONS_UPDATE","label":"Update ad association","group":"ads-campaign-management","entity":"Ad associations","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads ad associations","result":"Full model of updated ad associations.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adAssociations":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adAssociationId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adId":{"type":"string","minLength":1,"maxLength":4096},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"weight":{"type":"number","minimum":0,"maximum":100},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"endDateTime":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["adAssociations"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_ASSOCIATIONS_REMOVE","label":"Remove ad association","group":"ads-campaign-management","entity":"Ad associations","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Remove Amazon Ads ad associations","result":"Empty response.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adAssociations":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"adAssociationId":{"type":"string","minLength":1,"maxLength":4096},"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"adId":{"type":"string","minLength":1,"maxLength":4096},"state":{"type":"string","enum":["DRAFT","ENABLED","PAUSED","PROPOSED"]},"weight":{"type":"number","minimum":0,"maximum":100},"startDateTime":{"type":"string","minLength":1,"maxLength":4096},"endDateTime":{"type":"string","minLength":1,"maxLength":4096}},"additionalProperties":false}}},"required":["adAssociations"],"additionalProperties":false}},{"type":"AMAZON_ADS_AD_ASSOCIATIONS_FIND","label":"Find ad associations","group":"ads-campaign-management","entity":"Ad associations","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads ad associations","result":"Full model of found ad associations.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adAssociationQuery":{"type":"object","properties":{"adAssociationIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adGroupIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"adIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096},"description":"IDs to include. Amazon accepts up to 100 IDs per filter. When one ID filter has more IDs, DataDoe queries them in groups of 100 and merges the results. Only one ID filter per FIND can have more than 100 IDs."}},"required":["include"],"additionalProperties":false},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4130}},"additionalProperties":false}},"required":["adAssociationQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_PORTFOLIOS_ADD","label":"Add portfolio","group":"ads-campaign-management","entity":"Portfolios","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Add Amazon Ads portfolios","result":"Created portfolio entities.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"portfolios":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"portfolioId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["ENABLED"]},"budget":{"type":"object","properties":{"amount":{"anyOf":[{"type":"number"},{"type":"null"}]},"currencyCode":{"type":"string","enum":["AED","AUD","BRL","CAD","CLP","CNY","COP","EGP","EUR","GBP","INR","JPY","MXN","NGN","PLN","SAR","SEK","SGD","TRY","USD","ZAR"]},"endDate":{"anyOf":[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]},"policy":{"type":"string","enum":["DATE_RANGE","MONTHLY_RECURRING","NO_CAP","OTHER"]},"startDate":{"anyOf":[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]}},"additionalProperties":false},"budgetControls":{"type":"object","properties":{"campaignUnspentBudgetSharing":{"type":"object","properties":{"featureState":{"type":"string","enum":["DISABLED","ENABLED"]}},"required":["featureState"],"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false}}},"required":["portfolios"],"additionalProperties":false}},{"type":"AMAZON_ADS_PORTFOLIOS_UPDATE","label":"Update portfolio","group":"ads-campaign-management","entity":"Portfolios","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":250,"mcp":25},"description":"Update Amazon Ads portfolios","result":"Full model of updated portfolios.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"portfolios":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"portfolioId":{"type":"string","minLength":1,"maxLength":4096},"name":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["ENABLED"]},"budget":{"type":"object","properties":{"amount":{"anyOf":[{"type":"number"},{"type":"null"}]},"currencyCode":{"type":"string","enum":["AED","AUD","BRL","CAD","CLP","CNY","COP","EGP","EUR","GBP","INR","JPY","MXN","NGN","PLN","SAR","SEK","SGD","TRY","USD","ZAR"]},"endDate":{"anyOf":[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]},"policy":{"type":"string","enum":["DATE_RANGE","MONTHLY_RECURRING","NO_CAP","OTHER"]},"startDate":{"anyOf":[{"type":"string","minLength":1,"maxLength":4096},{"type":"null"}]}},"additionalProperties":false},"budgetControls":{"type":"object","properties":{"campaignUnspentBudgetSharing":{"type":"object","properties":{"featureState":{"type":"string","enum":["DISABLED","ENABLED"]}},"required":["featureState"],"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false}}},"required":["portfolios"],"additionalProperties":false}},{"type":"AMAZON_ADS_PORTFOLIOS_FIND","label":"Find portfolios","group":"ads-campaign-management","entity":"Portfolios","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads portfolios","result":"Full model of found portfolios.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"portfolioQuery":{"type":"object","properties":{"portfolioIdFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}}},"required":["include"],"additionalProperties":false},"stateFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","enum":["ENABLED"]}}},"required":["include"],"additionalProperties":false},"nameFilter":{"type":"object","properties":{"include":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"]}},"required":["include","queryTermMatchType"],"additionalProperties":false},"nextToken":{"type":"string","minLength":1,"maxLength":4096},"includeExtendedDataFields":{"type":"boolean"}},"additionalProperties":false}},"required":["portfolioQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BUDGET_RULES_ADD","label":"Create SP budget rules","group":"ads-budget-bid-rules","entity":"SP budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Create Sponsored Products budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"required":["name","ruleType","budgetIncreaseBy","duration"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BUDGET_RULES_UPDATE","label":"Update SP budget rules","group":"ads-budget-bid-rules","entity":"SP budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Update Sponsored Products budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string","minLength":1,"maxLength":256},"ruleState":{"type":"string","enum":["ACTIVE","PAUSED"]},"ruleDetails":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"additionalProperties":false}},"required":["ruleId"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BUDGET_RULES_ASSOCIATE","label":"Attach SP budget rules","group":"ads-budget-bid-rules","entity":"SP budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Associate Sponsored Products budget rules with campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"associations":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["campaignId","budgetRuleIds"],"additionalProperties":false}}},"required":["associations"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BUDGET_RULES_REMOVE","label":"Detach SP budget rules","group":"ads-budget-bid-rules","entity":"SP budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Remove Sponsored Products budget rules from campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"removals":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleId":{"type":"string","minLength":1,"maxLength":256}},"required":["campaignId","budgetRuleId"],"additionalProperties":false}}},"required":["removals"],"additionalProperties":false}},{"type":"AMAZON_ADS_SB_BUDGET_RULES_ADD","label":"Create SB budget rules","group":"ads-budget-bid-rules","entity":"SB budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Create Sponsored Brands budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["IS","NTB","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"required":["name","ruleType","budgetIncreaseBy","duration"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SB_BUDGET_RULES_UPDATE","label":"Update SB budget rules","group":"ads-budget-bid-rules","entity":"SB budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Update Sponsored Brands budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string","minLength":1,"maxLength":256},"ruleState":{"type":"string","enum":["ACTIVE","PAUSED"]},"ruleDetails":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["IS","NTB","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"additionalProperties":false}},"required":["ruleId"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SB_BUDGET_RULES_ASSOCIATE","label":"Attach SB budget rules","group":"ads-budget-bid-rules","entity":"SB budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Associate Sponsored Brands budget rules with campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"associations":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["campaignId","budgetRuleIds"],"additionalProperties":false}}},"required":["associations"],"additionalProperties":false}},{"type":"AMAZON_ADS_SB_BUDGET_RULES_REMOVE","label":"Detach SB budget rules","group":"ads-budget-bid-rules","entity":"SB budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Remove Sponsored Brands budget rules from campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"removals":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleId":{"type":"string","minLength":1,"maxLength":256}},"required":["campaignId","budgetRuleId"],"additionalProperties":false}}},"required":["removals"],"additionalProperties":false}},{"type":"AMAZON_ADS_SD_BUDGET_RULES_ADD","label":"Create SD budget rules","group":"ads-budget-bid-rules","entity":"SD budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Create Sponsored Display budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"required":["name","ruleType","budgetIncreaseBy","duration"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SD_BUDGET_RULES_UPDATE","label":"Update SD budget rules","group":"ads-budget-bid-rules","entity":"SD budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Update Sponsored Display budget rules","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"budgetRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string","minLength":1,"maxLength":256},"ruleState":{"type":"string","enum":["ACTIVE","PAUSED"]},"ruleDetails":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":256}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["GREATER_THAN","LESS_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number","minimum":0}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"additionalProperties":false}},"required":["ruleId"],"additionalProperties":false}}},"required":["budgetRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SD_BUDGET_RULES_ASSOCIATE","label":"Attach SD budget rules","group":"ads-budget-bid-rules","entity":"SD budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Associate Sponsored Display budget rules with campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"associations":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["campaignId","budgetRuleIds"],"additionalProperties":false}}},"required":["associations"],"additionalProperties":false}},{"type":"AMAZON_ADS_SD_BUDGET_RULES_REMOVE","label":"Detach SD budget rules","group":"ads-budget-bid-rules","entity":"SD budget rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Remove Sponsored Display budget rules from campaigns","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"removals":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"budgetRuleId":{"type":"string","minLength":1,"maxLength":256}},"required":["campaignId","budgetRuleId"],"additionalProperties":false}}},"required":["removals"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BID_RULES_ADD","label":"Create SP bid rules","group":"ads-budget-bid-rules","entity":"SP bid rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Create Sponsored Products scheduled bid increases. Useful for dayparting.","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bidRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"ruleName":{"type":"string","minLength":1,"maxLength":355},"bidIncreasePercent":{"type":"number"},"duration":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$"},"endTime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$"}},"required":["startTime"],"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"timesOfDay":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):00$"},"endTime":{"type":"string","pattern":"^(?:(?:[01]\\d|2[0-3]):00|24:00)$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"status":{"type":"string","enum":["ENABLED","PAUSED"]}},"required":["ruleName","bidIncreasePercent","duration","recurrence"],"additionalProperties":false}}},"required":["bidRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BID_RULES_UPDATE","label":"Update SP bid rules","group":"ads-budget-bid-rules","entity":"SP bid rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Update Sponsored Products scheduled bid increases. Useful for dayparting.","result":"Rule IDs and the outcome for each rule.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bidRules":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"optimizationRuleId":{"type":"string","minLength":1,"maxLength":256},"ruleName":{"type":"string","minLength":1,"maxLength":355},"bidIncreasePercent":{"type":"number"},"duration":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$"},"endTime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$"}},"required":["startTime"],"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","enum":["DAILY","WEEKLY"]},"daysOfWeek":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"timesOfDay":{"minItems":1,"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):00$"},"endTime":{"type":"string","pattern":"^(?:(?:[01]\\d|2[0-3]):00|24:00)$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"status":{"type":"string","enum":["ENABLED","PAUSED"]}},"required":["optimizationRuleId"],"additionalProperties":false}}},"required":["bidRules"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BID_RULES_FIND","label":"Find SP bid rules","group":"ads-budget-bid-rules","entity":"SP bid rules","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Find Sponsored Products scheduled bid increases. Useful for dayparting.","result":"Matching rules and a pagination token.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"optimizationRuleIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"campaignId":{"type":"string","minLength":1,"maxLength":256},"pageSize":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"type":"string","minLength":1,"maxLength":256}},"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BID_RULES_ASSOCIATE","label":"Attach SP bid rules","group":"ads-budget-bid-rules","entity":"SP bid rules","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":10},"description":"Associate Sponsored Products scheduled bid increases with campaigns. Useful for dayparting.","result":"Outcome for each rule and Campaign.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"associations":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1,"maxLength":256},"optimizationRuleIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["campaignId","optimizationRuleIds"],"additionalProperties":false}}},"required":["associations"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","label":"Find SP bid recommendations","group":"ads-recommendations-insights","entity":"SP bid recommendations","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":20},"description":"Find Sponsored Products bid recommendations for existing or new ad groups","result":"Bid recommendations per targeting.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bidRecommendations":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"object","properties":{"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"targetings":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CLOSE_MATCH","LOOSE_MATCH","SUBSTITUTES","COMPLEMENTS","KEYWORD_BROAD_MATCH","KEYWORD_EXACT_MATCH","KEYWORD_PHRASE_MATCH","PAT_ASIN","PAT_CATEGORY","PAT_CATEGORY_REFINEMENT","KEYWORD_GROUP"]},"value":{"type":"string","minLength":1,"maxLength":4096}},"required":["type"],"additionalProperties":false}}},"required":["adGroupId","targetings"],"additionalProperties":false},{"type":"object","properties":{"asins":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"uniqueItems":true},"targetings":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CLOSE_MATCH","LOOSE_MATCH","SUBSTITUTES","COMPLEMENTS","KEYWORD_BROAD_MATCH","KEYWORD_EXACT_MATCH","KEYWORD_PHRASE_MATCH","PAT_ASIN","PAT_CATEGORY","PAT_CATEGORY_REFINEMENT","KEYWORD_GROUP"]},"value":{"type":"string","minLength":1,"maxLength":4096}},"required":["type"],"additionalProperties":false}},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["LEGACY_FOR_SALES","AUTO_FOR_SALES","MANUAL","RULE_BASED"]},"adjustments":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","enum":["PLACEMENT_TOP","PLACEMENT_REST_OF_SEARCH","PLACEMENT_PRODUCT_PAGE"]},"percentage":{"type":"integer","minimum":0,"maximum":900}},"required":["predicate","percentage"],"additionalProperties":false}}},"required":["strategy"],"additionalProperties":false}},"required":["asins","targetings","bidding"],"additionalProperties":false}]}}},"required":["bidRecommendations"],"additionalProperties":false}},{"type":"AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","label":"Find SP target recommendations","group":"ads-recommendations-insights","entity":"SP target recommendations","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":20},"description":"Find Sponsored Products keyword recommendations for an ad group or ASINs","result":"Ranked keyword target recommendations.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targetRecommendations":{"minItems":1,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"object","properties":{"adGroupId":{"type":"string","minLength":1,"maxLength":4096},"maxRecommendations":{"type":"integer","minimum":1,"maximum":200},"sortDimension":{"type":"string","enum":["CLICKS","CONVERSIONS","DEFAULT"]},"locale":{"type":"string","enum":["ar_EG","de_DE","en_AE","en_AU","en_CA","en_GB","en_IN","en_SA","en_SG","en_US","es_ES","es_MX","fr_FR","it_IT","ja_JP","nl_NL","pl_PL","pt_BR","sv_SE","tr_TR","zh_CN"]}},"required":["adGroupId"],"additionalProperties":false},{"type":"object","properties":{"asins":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"uniqueItems":true},"biddingStrategy":{"type":"string","enum":["LEGACY_FOR_SALES","AUTO_FOR_SALES","MANUAL","RULE_BASED"]},"maxRecommendations":{"type":"integer","minimum":1,"maximum":200},"sortDimension":{"type":"string","enum":["CLICKS","CONVERSIONS","DEFAULT"]},"locale":{"type":"string","enum":["ar_EG","de_DE","en_AE","en_AU","en_CA","en_GB","en_IN","en_SA","en_SG","en_US","es_ES","es_MX","fr_FR","it_IT","ja_JP","nl_NL","pl_PL","pt_BR","sv_SE","tr_TR","zh_CN"]}},"required":["asins"],"additionalProperties":false}]}}},"required":["targetRecommendations"],"additionalProperties":false}},{"type":"AMAZON_ADS_PROGRAM_ELIGIBILITY_FIND","label":"Check advertising eligibility","group":"ads-recommendations-insights","entity":"Program eligibility","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Check which ad programs the Ads profile and, optionally, books can use","result":"Eligibility and reasons per program.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"programs":{"description":"Options for the program eligibility check (POST /eligibility/programs). Always runs; omit for defaults.","type":"object","properties":{"skipAllBillingChecks":{"description":"When true, Amazon skips billing checks (payment method, balance, tax info). Default false, so a missing payment method shows as a reason instead of being hidden.","type":"boolean"}},"additionalProperties":false},"products":{"description":"Optional product eligibility check (POST /eligibility/product/list) for the given ASINs and ad program.","type":"object","properties":{"adType":{"type":"string","enum":["sp","sb","sd"],"description":"Ad program the products are checked for: sp, sb or sd."},"asins":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"uniqueItems":true,"description":"Book or product ASINs to check. Amazon may return several offers per ASIN."}},"required":["adType","asins"],"additionalProperties":false}},"additionalProperties":false,"description":"Checks which Amazon Ads programs the connected profile can use and, optionally, whether given ASINs are eligible for one program. The programs result is keyed by program (SB, SD, MAAS, DTC, SPOT) with eligible and reasons; Sponsored Products is the baseline and is not listed. Eligibility is not a guarantee of ad delivery."}},{"type":"AMAZON_ADS_SB_HEADLINE_RECOMMENDATIONS_FIND","label":"Find SB headline recommendations","group":"ads-recommendations-insights","entity":"SB headlines","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":50,"mcp":20},"description":"Find Sponsored Brands headline suggestions for products","result":"Suggested headlines per item.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"headlineRecommendations":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"asins":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[A-Z0-9]{10}$"},"uniqueItems":true,"description":"Products of the planned ad, for example the book ASINs of a collection."},"maxNumSuggestions":{"type":"integer","minimum":1,"maximum":20},"adFormat":{"description":"Only SPONSORED_BRANDS is supported; Store Spotlight needs Store pages.","type":"string","enum":["SPONSORED_BRANDS"]}},"required":["asins"],"additionalProperties":false}}},"required":["headlineRecommendations"],"additionalProperties":false,"description":"Asks Amazon for Sponsored Brands headline suggestions for the given products (POST /sb/recommendations/creative/headline). Suggestions are Amazon text in the marketplace language; collection titles are limited to 32 characters since August 2026, so check the length before using one."}},{"type":"AMAZON_ADS_SB_INSIGHTS_FIND","label":"Find SB keyword insights","group":"ads-recommendations-insights","entity":"SB keyword insights","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Find keyword insights for planned Sponsored Brands ad groups","result":"Impression share, rank and alerts.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"campaignInsights":{"type":"object","properties":{"adGroups":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"adFormat":{"type":"string","enum":["PRODUCT_COLLECTION","STORE_SPOTLIGHT","VIDEO","BRAND_VIDEO"],"description":"Planned ad format of the ad group."},"keywords":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"keywordText":{"type":"string","minLength":1,"maxLength":80},"matchType":{"type":"string","enum":["EXACT","PHRASE","BROAD"]},"bid":{"type":"number","exclusiveMinimum":0,"description":"Planned bid in the profile currency."}},"required":["keywordText","matchType","bid"],"additionalProperties":false}}},"required":["adFormat","keywords"],"additionalProperties":false}},"nextToken":{"type":"string","minLength":1,"maxLength":4096}},"required":["adGroups"],"additionalProperties":false}},"required":["campaignInsights"],"additionalProperties":false,"description":"Returns pre-launch keyword insights for planned Sponsored Brands ad groups (POST /sb/campaigns/insights): search term impression share and rank and LOW_KEYWORD_TRAFFIC or LOW_BID alerts per keyword and bid. This is a planning signal, not campaign performance; use data tables for reporting."}},{"type":"AMAZON_ADS_AMC_AUDIENCES_ADD","label":"Create AMC audiences","group":"ads-audiences","entity":"AMC audiences","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Create rule-based AMC audiences for Sponsored Ads from SQL","result":"audienceExecutionId and status for each audience.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"audiences":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"audienceName":{"type":"string","minLength":1,"maxLength":128,"description":"Audience name. Amazon shows AMC audiences with an AMC prefix in Sponsored Ads. Use a unique name, because AMAZON_ADS_TARGETABLE_AUDIENCES_FIND searches by it."},"audienceDescription":{"type":"string","minLength":1,"maxLength":500,"description":"Optional audience description. Amazon does not allow changing it later."},"sql":{"type":"string","minLength":1,"maxLength":65536,"description":"AMC SQL that selects the audience members. The final SELECT must return only user_id, and every table must be an AMC audience table (name ending in _for_audiences, such as conversions_for_audiences, sponsored_ads_traffic_for_audiences, or amazon_attributed_events_by_traffic_time_for_audiences). Amazon does not return rows for audience queries; it builds the audience asynchronously. Amazon fails audiences with fewer than 2000 users; check the size first with COUNT(DISTINCT user_id) on the matching non-audience table through an AMC query."},"timeWindowStart":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Start of the AMC data the audience query reads, as a UTC date and time ending in Z."},"timeWindowEnd":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"End of the AMC data the audience query reads, as a UTC date and time ending in Z. AMC data is available up to about 48 hours before now."},"timeWindowRelative":{"type":"boolean","description":"When true, Amazon moves the time window forward on each audience refresh, so the audience keeps using recent data. Defaults to false."}},"required":["audienceName","sql","timeWindowStart","timeWindowEnd"],"additionalProperties":false}}},"required":["audiences"],"additionalProperties":false,"description":"Creates rule-based AMC audiences for Sponsored Ads in the Seller or Vendor's AMC instance. Amazon builds each audience asynchronously: poll AMAZON_ADS_AMC_AUDIENCES_FIND with the returned audienceExecutionId until status is SUCCEEDED (or FAILED with statusReason). Amazon makes a SUCCEEDED audience available in Sponsored Ads after about 24-48 hours; then find its Sponsored Ads audienceId with AMAZON_ADS_TARGETABLE_AUDIENCES_FIND."}},{"type":"AMAZON_ADS_AMC_LOOKALIKE_AUDIENCES_ADD","label":"Create AMC lookalike audiences","group":"ads-audiences","entity":"AMC audiences","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Create AMC lookalike audiences for Sponsored Ads from a seed query","result":"audienceExecutionId and status for each audience.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"audiences":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"audienceName":{"type":"string","minLength":1,"maxLength":128,"description":"Audience name. Amazon shows AMC audiences with an AMC prefix in Sponsored Ads. Use a unique name, because AMAZON_ADS_TARGETABLE_AUDIENCES_FIND searches by it."},"audienceDescription":{"type":"string","minLength":1,"maxLength":500,"description":"Optional audience description. Amazon does not allow changing it later."},"sql":{"type":"string","minLength":1,"maxLength":65536,"description":"AMC SQL that selects the seed audience Amazon models the lookalike audience on. The final SELECT must return only user_id, and every table must be an AMC audience table (name ending in _for_audiences, such as conversions_for_audiences, sponsored_ads_traffic_for_audiences, or amazon_attributed_events_by_traffic_time_for_audiences). Amazon does not return rows for audience queries; it builds the audience asynchronously. The seed needs 500 to 500000 users. Amazon creates only the lookalike audience, not the seed audience."},"timeWindowStart":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Start of the AMC data the audience query reads, as a UTC date and time ending in Z."},"timeWindowEnd":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"End of the AMC data the audience query reads, as a UTC date and time ending in Z. AMC data is available up to about 48 hours before now."},"timeWindowRelative":{"type":"boolean","description":"When true, Amazon moves the time window forward on each audience refresh, so the audience keeps using recent data. Defaults to false."},"lookalikeAudienceExpectedReach":{"type":"string","enum":["MOST_SIMILAR","SIMILAR","BALANCED","BROAD","MOST_BROAD"],"description":"How broad the lookalike audience is. Approximate sizes in North America and Europe: MOST_SIMILAR 0.5-1M, SIMILAR 1.5-3M, BALANCED 2-5.5M, BROAD 2.5-7.5M, MOST_BROAD 3-10M users. Amazon does not allow changing it later."}},"required":["audienceName","sql","timeWindowStart","timeWindowEnd","lookalikeAudienceExpectedReach"],"additionalProperties":false}}},"required":["audiences"],"additionalProperties":false,"description":"Creates AMC lookalike audiences for Sponsored Ads from a seed query. Amazon builds each audience asynchronously: poll AMAZON_ADS_AMC_AUDIENCES_FIND until status is SUCCEEDED, then wait about 24-48 hours and find its Sponsored Ads audienceId with AMAZON_ADS_TARGETABLE_AUDIENCES_FIND."}},{"type":"AMAZON_ADS_AMC_AUDIENCES_UPDATE","label":"Update AMC audiences","group":"ads-audiences","entity":"AMC audiences","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Update FAILED AMC audiences, for example to fix their SQL","result":"Outcome for each audience.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"audiences":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"audienceExecutionId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._-]+$","description":"audienceExecutionId returned when the audience was created."},"sql":{"type":"string","minLength":1,"maxLength":65536,"description":"New audience SQL. The final SELECT must return only user_id, and every table must be an AMC audience table (name ending in _for_audiences, such as conversions_for_audiences, sponsored_ads_traffic_for_audiences, or amazon_attributed_events_by_traffic_time_for_audiences). Amazon does not return rows for audience queries; it builds the audience asynchronously. Omit it to keep the current SQL."},"timeWindowStart":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Start of the AMC data the audience query reads, as a UTC date and time ending in Z."},"timeWindowEnd":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"End of the AMC data the audience query reads, as a UTC date and time ending in Z. AMC data is available up to about 48 hours before now."},"timeWindowRelative":{"type":"boolean","description":"When true, Amazon moves the time window forward on each audience refresh, so the audience keeps using recent data. Defaults to false."}},"required":["audienceExecutionId"],"additionalProperties":false,"description":"Amazon only updates audiences whose status is FAILED, for example to fix the SQL after reading statusReason. The name, type, description, and lookalike reach cannot change. Omitted fields keep their current values."}}},"required":["audiences"],"additionalProperties":false,"description":"Updates FAILED AMC audiences and makes Amazon build them again. Poll AMAZON_ADS_AMC_AUDIENCES_FIND afterwards."}},{"type":"AMAZON_ADS_AMC_AUDIENCES_REMOVE","label":"Delete AMC audiences","group":"ads-audiences","entity":"AMC audiences","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Delete AMC audiences","result":"Outcome for each audience.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"audienceExecutionIds":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._-]+$","description":"audienceExecutionId returned when the audience was created."}}},"required":["audienceExecutionIds"],"additionalProperties":false,"description":"Deletes AMC audiences. Amazon deletes only FAILED or SUCCEEDED audiences, and also deletes the audience segment from Sponsored Ads, so campaigns that use it lose it."}},{"type":"AMAZON_ADS_AMC_AUDIENCES_FIND","label":"Find AMC audiences","group":"ads-audiences","entity":"AMC audiences","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":25,"mcp":25},"description":"Find AMC audiences with their status and size","result":"Audiences and a pagination token.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"audienceExecutionIds":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._-]+$","description":"audienceExecutionId returned when the audience was created."}},"maxResults":{"description":"Page size when listing audiences without audienceExecutionIds.","type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous page when listing audiences.","type":"string","minLength":1,"maxLength":2048}},"additionalProperties":false,"description":"Gets AMC audiences of the Seller or Vendor with status (PENDING, RUNNING, SUCCEEDED, FAILED, DEACTIVATED), statusReason, audienceCount, and SQL. Omit audienceExecutionIds to list all audiences page by page. Free of charge; use it to poll a new audience every 15 to 30 minutes."}},{"type":"AMAZON_ADS_TARGETABLE_AUDIENCES_FIND","label":"Find AMC audiences in Sponsored Ads","group":"ads-audiences","entity":"Sponsored Ads audiences","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find the Sponsored Ads audience ID of AMC audiences","result":"Audience IDs, names, and a pagination token.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adProduct":{"type":"string","enum":["SPONSORED_PRODUCTS","SPONSORED_BRANDS","SPONSORED_DISPLAY"],"description":"Ad product that will use the audience."},"audienceName":{"description":"Searches AMC audiences by name. Omit it to list all AMC audiences.","type":"string","minLength":1,"maxLength":128},"maxResults":{"type":"integer","minimum":1,"maximum":250},"nextToken":{"type":"string","minLength":1,"maxLength":2048}},"required":["adProduct"],"additionalProperties":false,"description":"Finds the Sponsored Ads audienceId of AMC audiences (Audience Category > Custom-built > AMC). Amazon lists an AMC audience here about 24-48 hours after it SUCCEEDED in AMAZON_ADS_AMC_AUDIENCES_FIND; until then it is missing, so try again later. Attach the audienceId with AMAZON_ADS_CAMPAIGNS_UPDATE audienceBidAdjustments (Sponsored Products and Sponsored Brands bid boost) or AMAZON_ADS_TARGETS_ADD with targetType AUDIENCE (Sponsored Display)."}},{"type":"AMAZON_ADS_BRANDS_FIND","label":"Find ads brands","group":"ads-brands-creative-assets","entity":"Brands","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads brands for Sponsored Brands campaigns","result":"Brand details, including brand entity IDs.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"brandTypeFilter":{"type":"string","enum":["brandRegistry","bookAuthor"]}},"additionalProperties":false,"description":"Returns brandId (A…) and brandEntityId (ENTITY…). Use brandEntityId (ENTITY…) as brandId for AMAZON_ADS_CAMPAIGNS_ADD. brandEntityId matches AMAZON_ADS_CAMPAIGNS_FIND.brandId."}},{"type":"AMAZON_ADS_ASSETS_ADD","label":"Upload creative assets","group":"ads-brands-creative-assets","entity":"Creative assets","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":10,"mcp":5},"description":"Upload creative assets to the Creative Asset Library","result":"Per-file asset id, version, and status.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"assets":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"fileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":256},"assetType":{"type":"string","enum":["IMAGE","VIDEO"]},"assetSubTypes":{"minItems":1,"type":"array","items":{"type":"string","enum":["LOGO","PRODUCT_IMAGE","LIFESTYLE_IMAGE","OTHER_IMAGE","AUTHOR_IMAGE","BACKGROUND_VIDEO"]}},"asins":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"tags":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"adProduct":{"type":"string","minLength":1,"maxLength":256},"brandEntityId":{"type":"string","minLength":1,"maxLength":256}},"required":["fileId","name","assetType"],"additionalProperties":false}}},"required":["assets"],"additionalProperties":false}},{"type":"AMAZON_ADS_ASSETS_FIND","label":"Find creative assets","group":"ads-brands-creative-assets","entity":"Creative assets","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find creative assets","result":"Asset records and a nextToken for search.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"adProduct":{"type":"string","minLength":1,"maxLength":256},"assetQuery":{"anyOf":[{"type":"object","properties":{"assetIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string","minLength":1,"maxLength":256},"version":{"type":"string","minLength":1,"maxLength":256}},"required":["assetId"],"additionalProperties":false}}},"required":["assetIds"],"additionalProperties":false},{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":256},"filters":{"minItems":1,"type":"array","items":{"type":"object","properties":{"valueField":{"type":"string","enum":["TAG","ASIN","CAMPAIGN_NAME","CAMPAIGN_ID","PROGRAM","ASSET_TYPE","ASSET_SUB_TYPE","APPROVED_AD_POLICY","ASSET_EXTENSION"]},"values":{"minItems":1,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["valueField","values"],"additionalProperties":false}},"sortCriteria":{"type":"object","properties":{"field":{"type":"string","enum":["CREATED_TIME","SIZE","NAME","IMAGE_HEIGHT","IMAGE_WIDTH","EXTENSION"]},"order":{"type":"string","enum":["ASC","DESC"]}},"required":["field","order"],"additionalProperties":false},"pageSize":{"type":"integer","minimum":1,"maximum":500},"nextToken":{"type":"string","minLength":1,"maxLength":256}},"additionalProperties":false}]}},"required":["assetQuery"],"additionalProperties":false}},{"type":"AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND","label":"Find Attribution publishers","group":"ads-attribution","entity":"Publishers and advertisers","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Find Amazon Attribution publishers","result":"Publisher IDs and names.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"description":"Lists Amazon Attribution publishers (id, name, macroEnabled) for the connected profile. Requires a profile with Amazon Attribution access; other profiles receive an Amazon authorization error."}},{"type":"AMAZON_ADS_ATTRIBUTION_ADVERTISERS_FIND","label":"Find Attribution advertisers","group":"ads-attribution","entity":"Publishers and advertisers","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Find Amazon Attribution advertisers","result":"Advertiser IDs and names.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false,"description":"Lists Amazon Attribution advertisers for the connected Ads profile. Modern ad-console profiles have one advertiser. Older DSP vendor profiles can have more than one. Amazon plans to remove this endpoint, so use it only when a profile can have more than one advertiser. Requires a profile with Amazon Attribution access."}},{"type":"AMAZON_ADS_ATTRIBUTION_MACRO_TAGS_FIND","label":"Find Attribution macro tags","group":"ads-attribution","entity":"Tags and links","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Find Amazon Attribution macro tags","result":"Tags by advertiser and publisher.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publisherIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"description":"Publisher IDs from AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND. DataDoe sends them as one comma-separated value."},"advertiserIds":{"description":"Attribution advertiser IDs. Omit this to request every advertiser on the profile. Modern ad-console profiles have one advertiser.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["publisherIds"],"additionalProperties":false,"description":"Returns Amazon Attribution macro tags for publishers whose macroEnabled value is true. A live run calls Amazon and turns Attribution measurement on for this profile. A dry run checks the request and does not call Amazon. Keep API tags separate from tags created in the Ads console. Leave the publisher macros in the tag. The publisher replaces them when the ad is served. One tag can be reused for that advertiser's campaigns on that publisher."}},{"type":"AMAZON_ADS_ATTRIBUTION_NON_MACRO_TAG_TEMPLATES_FIND","label":"Find Attribution tag templates","group":"ads-attribution","entity":"Tags and links","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Find Amazon Attribution tag templates","result":"Templates with ID placeholders.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publisherIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"description":"Publisher IDs from AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND. DataDoe sends them as one comma-separated value."},"advertiserIds":{"description":"Attribution advertiser IDs. Omit this to request every advertiser on the profile. Modern ad-console profiles have one advertiser.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["publisherIds"],"additionalProperties":false,"description":"Returns Amazon Attribution tag templates for publishers that do not support macros. A live run calls Amazon and turns Attribution measurement on for this profile. A dry run checks the request and does not call Amazon. Keep API tags separate from tags created in the Ads console. Each template has placeholders for the campaign, ad group, and creative IDs. Replace every placeholder before using the link, or use AMAZON_ADS_ATTRIBUTION_TAGS_GENERATE. A filled tag belongs to one landing page. A new landing page needs a new creative ID."}},{"type":"AMAZON_ADS_ATTRIBUTION_REPORTS_FIND","label":"Find Attribution reports","group":"ads-attribution","entity":"Reports","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Read a live Amazon Attribution report","result":"Report rows, size, and cursor.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reportType":{"default":"PERFORMANCE","description":"PERFORMANCE or PRODUCTS. Defaults to PERFORMANCE.","type":"string","enum":["PERFORMANCE","PRODUCTS"]},"groupBy":{"description":"PERFORMANCE aggregation: CAMPAIGN, ADGROUP, or CREATIVE. Amazon defaults to CREATIVE. Do not send this for PRODUCTS.","type":"string","enum":["CAMPAIGN","ADGROUP","CREATIVE"]},"startDate":{"type":"string","description":"First report date, as YYYYMMDD."},"endDate":{"type":"string","description":"Last report date, as YYYYMMDD."},"advertiserIds":{"description":"Attribution advertiser IDs. Omit this to request every advertiser on the profile. Modern ad-console profiles have one advertiser.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"metrics":{"description":"Metrics to return. Omit this to receive every metric except brb_bonus_amount. Request brb_bonus_amount only on a PERFORMANCE report grouped by CAMPAIGN or ADGROUP.","minItems":1,"type":"array","items":{"type":"string"}},"count":{"description":"Page size, from 1 to 5,000.","type":"integer","minimum":1,"maximum":5000},"cursorId":{"description":"Leave empty for the first page. For the next page, send the cursorId from the previous response unchanged, with the same other inputs.","type":"string","maxLength":8000}},"required":["startDate","endDate"],"additionalProperties":false,"description":"Reads an Amazon Attribution report in the same request. This is not an asynchronous Ads report, and it does not turn measurement on. Prefer the amazon_ads_attribution tables for routine analysis. PERFORMANCE history is 13 months and can be grouped by CAMPAIGN, ADGROUP, or CREATIVE. PRODUCTS history is 90 days, stays at ad group and product level, and includes only the top 100 products per campaign. Amazon hides metrics for a tag with fewer than 10 lifetime clicks. Events are reported on the event date using a 14-day last click."}},{"type":"AMAZON_ADS_ATTRIBUTION_TAGS_GENERATE","label":"Generate Attribution links","group":"ads-attribution","entity":"Tags and links","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":1,"mcp":1},"description":"Build an Amazon Attribution tracking link","result":"Tracking URL and tag parameters.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publisherId":{"type":"string","minLength":1,"maxLength":64,"description":"One publisher ID from AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND."},"advertiserId":{"description":"Attribution advertiser ID. Omit this when the profile has one advertiser. When Amazon returns more than one, a link is built for each unless you set this.","type":"string","minLength":1,"maxLength":64},"landingUrl":{"type":"string","description":"Amazon product detail page or Brand Store page that the ad should open."},"tagMode":{"type":"string","enum":["MACRO","NON_MACRO"],"description":"MACRO keeps the publisher macros. NON_MACRO fills the campaign, ad group, and creative IDs. Use MACRO only when the publisher macroEnabled value is true."},"campaignId":{"description":"Campaign ID for a non-macro tag. Do not reuse one campaign ID across advertisers or marketplaces.","type":"string","minLength":1,"maxLength":255},"adGroupId":{"type":"string","minLength":1,"maxLength":255},"creativeId":{"description":"Creative ID for a non-macro tag. Changing the landing page requires a new creative ID.","type":"string","minLength":1,"maxLength":255}},"required":["publisherId","landingUrl","tagMode"],"additionalProperties":false,"description":"Builds a ready-to-use Amazon Attribution tracking link for one publisher. A live run reads the tag from Amazon and turns measurement on for this profile. A dry run checks the landing page and identifiers and does not call Amazon. In NON_MACRO mode DataDoe percent-encodes the filled IDs in the tracking URL. The tag parameters are the IDs you entered. This Action does not publish the link to an advertising account and does not simulate a click. Do not change a console-created Attribution tag for API use."}},{"type":"AMAZON_ADS_COMMUNICATION_CONTACTS_ADD","label":"Add ads communication contacts","group":"ads-account-communication","entity":"Contacts","access":"WRITE","requiresPii":true,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5,"mcp":5},"description":"Add account support contacts to the Amazon Ads account (Amazon open beta)","result":"Created or already existing contacts.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"communicationContacts":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["EMAIL","PHONE"]},"contactPurpose":{"description":"Defaults to ACCOUNT_SUPPORT, the only purpose Amazon accepts.","type":"string","enum":["ACCOUNT_SUPPORT"]},"contactAddress":{"type":"object","properties":{"emailAddress":{"description":"Email address. Required when channel is EMAIL.","type":"string","maxLength":320,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phoneNumber":{"description":"E.164 phone number, such as +442071234567. Required when channel is PHONE.","type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false,"description":"Send exactly one of emailAddress or phoneNumber, matching channel."},"preferredContact":{"description":"Whether this is the preferred contact when several contacts exist for the same purpose.","type":"boolean"},"timeZone":{"description":"IANA time zone from Amazon's list of 44 values. Zones outside the list, such as Europe/Berlin or Europe/Warsaw, are rejected.","type":"string","enum":["America/Anchorage","America/Caracas","America/Chicago","America/Denver","America/Halifax","America/Los_Angeles","America/Mexico_City","America/New_York","America/Sao_Paulo","America/St_Johns","Asia/Almaty","Asia/Baghdad","Asia/Bangkok","Asia/Dubai","Asia/Hong_Kong","Asia/Kabul","Asia/Kathmandu","Asia/Kolkata","Asia/Magadan","Asia/Riyadh","Asia/Shanghai","Asia/Singapore","Asia/Tehran","Asia/Tokyo","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/South_Georgia","Australia/Brisbane","Australia/Darwin","Australia/Sydney","EET","Europe/Amsterdam","Europe/Istanbul","Europe/London","Europe/Paris","Europe/Stockholm","Indian/Cocos","Pacific/Auckland","Pacific/Fiji","Pacific/Honolulu","Pacific/Kwajalein","Pacific/Midway","UTC"]}},"required":["channel","contactAddress"],"additionalProperties":false}}},"required":["communicationContacts"],"additionalProperties":false,"description":"Amazon open beta: Amazon may change this contract before general availability. Adds account support contacts to the connected Amazon Ads account. Requires the account edit (account_edit) permission. Amazon cannot edit or delete a contact through the API, so validate with dryRun first. DataDoe sends one contact per Amazon request and skips an address that already exists, returning it with alreadyExists: true. Amazon does not document whether contacts apply to one Amazon Ads profile or to the whole Amazon Ads account."}},{"type":"AMAZON_ADS_COMMUNICATION_CONTACTS_FIND","label":"Find ads communication contacts","group":"ads-account-communication","entity":"Contacts","access":"READ","requiresPii":true,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads account support contacts (Amazon open beta)","result":"Contacts and a pagination token.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"channel":{"type":"string","enum":["EMAIL","PHONE"],"description":"Contact channel to list: EMAIL or PHONE."},"contactPurpose":{"type":"string","enum":["ACCOUNT_SUPPORT"]},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4096}},"required":["channel"],"additionalProperties":false,"description":"Amazon open beta: Amazon may change this contract before general availability. Lists communication contacts of the connected Amazon Ads account. Requires the account view (account_view) or account edit (account_edit) permission."}},{"type":"AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND","label":"Find ads communication preferences","group":"ads-account-communication","entity":"Preferences","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":null,"description":"Find Amazon Ads communication preferences and their categories (Amazon open beta)","result":"Preferences, categories, and a pagination token.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"channel":{"type":"string","enum":["EMAIL","UI"],"description":"Preference channel to list: EMAIL or UI (in-app)."},"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"description":"nextToken from the previous FIND response. Send it with the same query to get the next page.","type":"string","minLength":1,"maxLength":4096}},"required":["channel"],"additionalProperties":false,"description":"Amazon open beta: Amazon may change this contract before general availability. Lists communication preferences and their categories. Returns the communicationPreferenceId and categoryId values that AMAZON_ADS_COMMUNICATION_PREFERENCES_UPDATE needs. Requires the account view (account_view) or account edit (account_edit) permission. Preferences belong to the Amazon Ads profile of the selected Seller or Vendor. Other marketplaces on the same Amazon Ads account have their own preferences and IDs."}},{"type":"AMAZON_ADS_COMMUNICATION_PREFERENCES_UPDATE","label":"Update ads communication preferences","group":"ads-account-communication","entity":"Preferences","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":2,"mcp":2},"description":"Update Amazon Ads communication preferences (Amazon open beta)","result":"Updated and previous preference for each item.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"communicationPreferences":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"object","properties":{"communicationPreferenceId":{"type":"string","minLength":1,"maxLength":256,"description":"communicationPreferenceId from AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND."},"communicationsEnabled":{"type":"boolean","description":"false suppresses every communication on this channel. true requires at least one categoryPreferences entry."},"categoryPreferences":{"description":"Categories to change. Categories you omit keep their current subscription: DataDoe sends Amazon the full current list with these changes applied.","maxItems":25,"type":"array","items":{"type":"object","properties":{"categoryId":{"type":"string","minLength":1,"maxLength":256,"description":"categoryId from AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND."},"isCategorySubscribed":{"type":"boolean"}},"required":["categoryId","isCategorySubscribed"],"additionalProperties":false}}},"required":["communicationPreferenceId","communicationsEnabled"],"additionalProperties":false}}},"required":["communicationPreferences"],"additionalProperties":false,"description":"Amazon open beta: Amazon may change this contract before general availability. Updates communication preferences. Use AMAZON_ADS_COMMUNICATION_PREFERENCES_FIND first for communicationPreferenceId and categoryId values. Requires the account edit (account_edit) permission. The result includes previousCommunicationPreference next to Amazon's updated communicationPreference. Preferences belong to the Amazon Ads profile of the selected Seller or Vendor. Other marketplaces on the same Amazon Ads account have their own preferences and IDs."}},{"type":"AMAZON_ADS_PARTNER_OPPORTUNITIES_FIND","label":"Find partner opportunities","group":"ads-partner-opportunities","entity":"Opportunities","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":5000,"mcp":10},"description":"Read one page of the Amazon Ads Partner Network catalog","result":"Catalog metadata and a nextToken.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"maxResults":{"type":"integer","minimum":1,"maximum":100},"nextToken":{"type":"string","minLength":1,"maxLength":4096},"locale":{"type":"string","minLength":2,"maxLength":35},"audience":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"objectiveType":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"product":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"advertiserId":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"profileId":{"maxItems":20,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"description":"One page of the partner opportunity catalog for the Ads connection Partner Network account. Advertiser and profile filters are alternatives. The response omits partner-wide advertiser and row counts."}},{"type":"AMAZON_ADS_PARTNER_RECOMMENDATIONS_APPLY","label":"Apply partner recommendations","group":"ads-partner-opportunities","entity":"Recommendations","access":"WRITE","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":100,"mcp":100},"description":"Apply Amazon account team recommendations that share one Partner Network opportunity","result":"Accepted and rejected recommendation IDs.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"partnerOpportunityId":{"type":"string","minLength":1,"maxLength":512},"advertiserType":{"type":"string","enum":["SELLER","VENDOR"]},"encryptedAdvertiserId":{"type":"string","minLength":1,"maxLength":512},"entityId":{"type":"string","minLength":1,"maxLength":512},"marketplace":{"type":"string","enum":["AE","AU","BR","CA","DE","EG","ES","FR","GB","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","UK","US"]},"recommendationIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":512}}},"required":["partnerOpportunityId","advertiserType","encryptedAdvertiserId","entityId","marketplace","recommendationIds"],"description":"Apply account-team recommendations that share one partner opportunity, advertiser, entity, and marketplace. Accepted means Amazon queued the change. It does not mean the change is complete."}},{"type":"AMAZON_ADS_PARTNER_RECOMMENDATION_STATUS_FIND","label":"Find partner recommendation status","group":"ads-partner-opportunities","entity":"Recommendations","access":"READ","requiresPii":false,"accountAvailability":"SELLERS_AND_VENDORS","marketplaceNote":null,"maxItems":{"api":500,"mcp":500},"description":"Read the status of applied Partner Network recommendations","result":"Campaign ID, recommendation ID, and Amazon status.","detailsJsonSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"partnerOpportunityId":{"type":"string","minLength":1,"maxLength":512},"advertiserType":{"type":"string","enum":["SELLER","VENDOR"]},"encryptedAdvertiserId":{"type":"string","minLength":1,"maxLength":512},"entityId":{"type":"string","minLength":1,"maxLength":512},"marketplace":{"type":"string","enum":["AE","AU","BR","CA","DE","EG","ES","FR","GB","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","UK","US"]},"recommendationIds":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":512}}},"required":["partnerOpportunityId","advertiserType","encryptedAdvertiserId","entityId","marketplace","recommendationIds"],"description":"Read application status for recommendations in one partner opportunity scope. This does not submit a new apply request."}}]}