Preview Production Schedule Regenerate
Beta/v1/operations/production-schedules/{id}/actions/preview-regenerateThis endpoint is idempotent. Learn more
Returns what regenerating this draft would change, without changing it.
Every campaign either plan holds is listed, including the ones both agree on, so the caller can render a full side-by-side rather than a list of surprises. discarded_manual_count is what replace_all would destroy — a regenerate that silently eats hand-work is abandoned within two cycles, so the destructive mode has to be able to state its cost before it runs.
Planning inputs default to the ones the version was generated with, so a plain preview answers "what would the solver say now" rather than answering a different question with a different horizon.
idstringID of the production schedule.
planning_as_ofoptional string (date-time)Date to plan from. Defaults to the date the version was generated for.
horizon_weeksoptional integerWeeks the plan should cover. Defaults to the version's own horizon.
demand_basisoptional stringenumValues:trailing_12seasonal_emaHow demand is derived. Defaults to the version's own basis.
objectstringenumValues:production_schedule_regenerate_previewResource type identifier.
production_scheduleentitynullableThe draft this would act on.
idstringUnique identifier for the entity.
objectstringenumValues:entityResource type identifier.
typestringenumValues:accountactorentityThe resource kind that this entity references, as an object-type value (e.g. user, account).
Unlike object — which is always entity — this names the underlying resource the id points to.
namestringnullableHuman-readable display name for the entity (e.g. a user's full name, a sales order number).
handlestringnullableSecondary human-readable identifier (e.g. email address, username, redacted API key value).
solver_versionstringWhich solver produced the proposal.
planning_as_of_atstring (date-time)The instant the fresh solve planned from.
Every campaign either plan holds, including the ones both agree on.
objectstringenumValues:listResource type identifier.
page_infoobjectPagination metadata.
next_page_urlstringnullableRelative URL that fetches the next page of results.
null when the last page has been reached.
previous_page_urlstringnullableRelative URL that fetches the previous page of results.
null while on the first page.
has_next_pagebooleanWhether more results exist after this page.
has_prev_pagebooleanWhether results exist before this page.
dataarray of objectResources in this page.
changestringenumValues:addedremovedchangedWhat the regenerate would do to this campaign.
itementitynullableThe item the campaign produces.
idstringUnique identifier for the entity.
objectstringenumValues:entityResource type identifier.
typestringenumValues:accountactorentityThe resource kind that this entity references, as an object-type value (e.g. user, account).
Unlike object — which is always entity — this names the underlying resource the id points to.
namestringnullableHuman-readable display name for the entity (e.g. a user's full name, a sales order number).
handlestringnullableSecondary human-readable identifier (e.g. email address, username, redacted API key value).
skustringSKU of that item.
machineentitynullableThe machine the campaign runs on.
idstringUnique identifier for the entity.
objectstringenumValues:entityResource type identifier.
typestringenumValues:accountactorentityThe resource kind that this entity references, as an object-type value (e.g. user, account).
Unlike object — which is always entity — this names the underlying resource the id points to.
namestringnullableHuman-readable display name for the entity (e.g. a user's full name, a sales order number).
handlestringnullableSecondary human-readable identifier (e.g. email address, username, redacted API key value).
week_indexintegerZero-based horizon week.
current_quantitynumberUnits the current plan asks for. Zero when the campaign is being added.
proposed_quantitynumberUnits the fresh solve asks for. Zero when the campaign is being removed.
current_is_manualbooleanWhether the current campaign was created or edited by a person.
added_countintegerCampaigns the fresh solve wants that the current plan does not have.
removed_countintegerCampaigns the current plan has that the fresh solve does not want.
changed_countintegerCampaigns both hold, in different quantities.
manual_line_countintegerHand-edited campaigns currently on the draft.
discarded_manual_countintegerHand-edited campaigns replace_all would destroy.
Responses
Successful response for Preview Production Schedule Regenerate