Skip to main content

Set FBA Minimum

PUT 
/api/amazon/:integrationInstance/fba-stock-floors

Create or update one FBA minimum: a product's floor in one FBA region, or the region default when product_id is null. Only the fields sent are written; an explicit null clears a field so it inherits from the region default. The pair (or, for a region default, the whole region) is re-evaluated immediately without alerting — the next sweep decides alerts.

Not yet available to API tokens

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

Body fields:

  • region_code (required, string): an FBA region of the account — a country code, or EU for the Pan-European pool (case-insensitive)
  • product_id (required, integer|null): the product; null for the region default. Must be sent.
  • floor_mode (nullable): units | days | greater_of
  • min_units (nullable, integer 0–4294967295): required (after inheritance) for units and greater_of
  • min_days_of_cover (nullable, integer 1–365): required (after inheritance) for days and greater_of
  • route_type (nullable): supplier | own_warehouse | third_party_warehouse | awd — the route whose lead time a days floor plans with; null = the region's primary route
  • route_source_id (nullable, integer): supplier id (supplier route) or warehouse id (other routes); validated against the route the row will have — sent alone it pairs with the stored route_type, and changing route_type without it clears the stored source (422 Supplier not found / Warehouse not found / Choose a route before choosing its source)
  • include_inbound (nullable, boolean): count inbound units toward the floor
  • ignore_inbound_after_days (nullable, integer 7–180): stop counting inbound shipments older than this
  • alerts_enabled (nullable, boolean): raise FBA low-stock alerts for this floor
  • primary_route_type (nullable, region default only): the region's primary route type
  • primary_route_source_id (nullable, integer, region default only): source of the primary route

Returns the resulting row (same shape as List FBA Minimums).

Requires the fba_stock_floors.update permission.

Authentication: Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type