Skip to main content

Generate Content Update Previews

POST 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/shipments/:plan_shipment/content-updates/generate

Start generating content update previews ("Adjust shipment") for a shipped shipment via the async SP-API generateShipmentContentUpdatePreviews operation — used to correct box contents / item quantities after the fact. Dispatches the tracked job "Generate FBA Content Update Previews: {plan name}" and returns its tracked_job_log_id for the tracked job log endpoints; once the job completes, fetch the previews via List Content Update Previews and apply one via Confirm Content Update Preview.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Boxes and items are passed through to Amazon in SP-API shape — only the load-bearing keys are validated locally; everything else is validated by Amazon (failures surface on the tracked job).

Fields:

  • boxes (array, required, min 1) — the full updated box list in SP-API shape: contentInformationSource, dimensions (length/width/height/unitOfMeasurement), weight (value/unit), quantity, and items (msku/quantity/labelOwner/prepOwner, optional expiration)
  • items (array, required, min 1) — the updated shipment item totals:
    • items.*.msku (string, required, max 255)
    • items.*.quantity (integer, required, min 0) — the new total shipped quantity for the MSKU
    • items.*.labelOwner / items.*.prepOwner / items.*.expiration — passed through to Amazon when provided

Errors:

  • 404 — the shipment does not belong to this draft inbound plan
  • 422 — validation failure (boxes/items missing or empty, item rows missing msku/quantity)

Authentication: Bearer token (PAT).

Request​

Responses​

OK

Response Headers
    Content-Type