Update Box
PATCH/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/boxes/:box
Update a box's attributes and/or its packed items. Returns 404 if the box does not belong to the draft inbound plan.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Fields (all optional):
amazon_fba_carton_template_id(integer, nullable) — must exist in carton templateslength(numeric, nullable, > 0)width(numeric, nullable, > 0)height(numeric, nullable, > 0)weight(numeric, nullable, > 0)dimension_unit(string,INorCM)weight_unit(string,LBorKG)items(array) — full-replace set of the box's items. When present, ALL existing box items are deleted and replaced with this set:items.*.draft_amazon_fba_inbound_plan_item_id(integer, required) — must exist, must belong to this plan, and its MSKU must be part of the box's packing group (422 otherwise)items.*.quantity(integer, required, min 1)items.*.expiration_date(date, optional, nullable, must be today or later — "Expiration dates cannot be in the past.")
The authenticated user is recorded as packed_by_user_id on each created item.
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.
Unprocessable Entity
Response Headers
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.