Recut Forecast Run Cash Plan
POST/api/forecast-runs/:run/cash-plan/recut
Re-cut a saved forecast run's cash plan against today's headroom and ranking weights, using the ranking inputs already stored on its lines. The forecast is not rebuilt. Each line is re-dated to the later of today and its order-by date (payment milestones move with it), existing pins and supplier minimums carry over, and the stored plan is replaced so the run reopens with the new cut.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Use it after cash, credit, reserve, payables or weights change, so the saved plan matches what Rank Forecast Builds would return today.
Balance inputs (cash_on_hand, credit_line_limit, credit_line_drawn, available_credit, reserve_floor, snapshot_id, reserve_periods, and each week's reserve / reserve_label, capacity, spendable and spendable_after) are only present for users holding cash_buying.view_balances; without it these keys are omitted entirely (not null).
Permission: cash_buying.override. Token scope: purchase-orders:write.
No request body.
sized_unit_cost (on each line): the unit cost, in the line's pricing currency (as the purchase order carries it), that the line's cash was sized at. Compare it with the product's current cost to tell a plan ranked at old costs from the current ones; null on plans saved before it was recorded.
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
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.