Delete Inbound Shipment
DELETE/api/amazon/:integrationInstance/inbound/shipments/:shipment
Permanently delete a legacy FBA inbound shipment and its downloaded items. Deletion is blocked with a 422 response when the shipment is linked to a purchase order or warehouse transfer — unprocess the shipment first to remove the link. Deleting only removes the local record; the shipment on Amazon is unaffected and an active shipment can reappear on the next refresh.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token.
Requires the integrations.update permission.
Returns 404 when the inbound shipment belongs to a different Amazon account than the one in the URL.
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
Response Headers
Not Found
Response Headers
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.