/api/v1/promotions/previewDry-run a rollover — writes nothing
promotion:viewDeclared request fields: fromSessionId (required), toSessionId (required), criteria (optional).
Use year-end rollover in the school workspace. Preview new-session student placement and apply or revert a recorded promotion batch.
Intended access: Assigned account with the required permissions.
promotion:viewpromotion:createpromotion:managepromotion:deleteUse the public sample demo to learn this flow. Your assigned ERP account determines access to actual school records.
A school account with the permissions shown below.
Undo is part of the documented workflow.
Dry-run a rollover — writes nothing is part of the documented workflow.
Review the result in the connected record or workspace before moving on.
The screen exposes the following context or input controls. Required fields are validated by the live application.
Source inventory checked on 11 October 2026. Guide availability confirms documentation publication, not certification of every external service or device flow.
Open a guided sample workspace, try the available actions, then reset whenever you like. No login required.
These are the source-matched API operations connected to this guide. Reading this reference does not execute any request.
/api/v1/promotions/previewDry-run a rollover — writes nothing
promotion:viewDeclared request fields: fromSessionId (required), toSessionId (required), criteria (optional).
/api/v1/promotions/clone-structureCopy classes/sections/subjects into the new session
promotion:createDeclared request fields: fromSessionId (required), toSessionId (required), includeTimetables (optional).
/api/v1/promotions/commitApply the rollover (transactional)
promotion:manageDeclared request fields: fromSessionId (required), toSessionId (required), decisions (required), activateTargetSession (optional), notes (optional), graduationYear (optional).
/api/v1/promotions/batches/:id/revertRevert
promotion:delete/api/v1/promotions/batchesBatches
promotion:viewERP links use your assigned account. Record-specific pages start from the list so you can choose a real record.