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.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

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