Update Item
PATCH/api/amazon/:integrationInstance/draft-inbound-plans/items/:draft_inbound_plan_item
Update a single draft plan item.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Auth: Requires Bearer token.
Body fields (all optional — only provided fields are updated):
- product_id (int)
- msku (string)
- quantity (int)
- label_owner (string|null)
- prep_owner (string|null)
- expiration (date|null)
- manufacturing_lot_code (string|null)
- kit_fulfillment_mode (string|null): how a KIT line is fulfilled from the source warehouse —
kit_stock(ship existing pre-built kit stock as-is) orcomponents(assemble the kit from component stock at the source warehouse when the plan is verified/allocated). Only meaningful for kit products with a non-supplier (3PL/direct) source; ignored otherwise. - case_pack_qty (int|null): case pack size snapshot for this line.
- case_pack_rounding (string|null): rounding strategy snapshot for this line —
always_round_up,always_round_down, orround_nearest.
Returns the updated item, including product_id, is_kit, kit_fulfillment_mode, kit_availability (live kit-on-hand vs buildable-from-components, with the bottleneck component), and case_pack_qty / case_pack_rounding for kit lines.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.