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.

Authorization

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

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.

Request​

Responses​

OK

Response Headers
    Content-Type