Re-apply a saved version's config to the live forecast

POST/api/v1/businesses/{business_id}/cfo-portal/cash-forecast/versions/{version_id}/apply

Load a saved version into the user's working scope.

Pushes the version's budget exclusion list to business settings and replays its overrides into the working scope so the live forecast recomputes against the saved configuration. The caller should invalidate the cash-forecast query and use budget_id from the response to sync any local budget-selector state.

Operation ID: cfo_portal_apply_version_api_v1_businesses__business_id__cfo_portal_cash_forecast_versions__version_id__apply_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

business_idstringrequired
version_idstringrequired

Responses

201Successful Response

Schema: SuccessEnvelope_CashForecastVersionApplyResponse_

successboolean
messagestring
codestring
dataCashForecastVersionApplyResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

POST/api/v1/businesses/{business_id}/cfo-portal/cash-forecast/versions/{version_id}/apply

bash

curl -X POST 'https://api.ondayzero.com/api/v1/businesses/{business_id}/cfo-portal/cash-forecast/versions/{version_id}/apply' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID'