Record Product Aging Action
PUT/api/inventory-aging/actions/:product
Create or update the aging action state for a product. One state per product:
needs_action— default; nothing recorded yetin_progress— a clearance action was recorded (action_typerequired: price_reduced, listed_on_channel, promotion, bundled, transferred, removal_ordered, written_down, other)resolved— the aged stock was dealt with (resolutionrequired: sold_through, cleared, written_off)accepted— deliberate long-tail stock; optionalsnooze_until(today or later) keeps it out of the needs-attention scope until that date
note (max 1000 chars) and assigned_to (an active user belonging to the current account) are optional on every status; action_type is rejected for accepted/needs_action and resolution outside resolved. Each write stamps who acted and when.
When granular permissions are enabled for the account, this endpoint requires the inventory.manage_aging permission.
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.