Skip to main content

Confirm Placement Option

POST 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/placement-options/:placement_option/confirm

Confirm one of the offered placement options for the plan (Amazon FBA Inbound v2024-03-20 confirmPlacementOption operation). Confirmation is irreversible — once a placement option is confirmed the other options expire, and only the confirmed split's shipments remain the plan's real shipments.

Not yet available to API tokens

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

This is an asynchronous endpoint: it dispatches a tracked background job and returns { "data": { "tracked_job_log_id": <id> } } immediately. Progress is visible via the tracked job log endpoints, and the underlying Amazon operation is resolved by the amazon_inbound_operations poller (a background job).

Tracked job name: Confirm FBA Placement Option: {plan name}. When the job completes, the option is marked confirmed, every other option of the plan is marked expired, and the confirmed shipments can be retrieved with List Shipments.

Pre-flight validation (HTTP 422, checked synchronously before the job is dispatched):

  • the placement option must not be expired (status expired or expiration in the past)
  • no placement option may already be confirmed for the plan — including this one (placement confirmation is irreversible)

Returns 404 when the placement option does not belong to the draft inbound plan.

No request body is required.

Returns 404 when the inbound plan (or a shipment, box, option or item nested under it) in the path belongs to a different Amazon account than the one in the URL.

Request​

Responses​

OK

Response Headers
    Content-Type