Advance students to the next academic year

POST

https://ssuccessv2.com/app/api/v2/school/structure/advance/:from_year/:to_year

Migrates selected grade or class students from one academic year into another with optional status mappings.

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

from_yearintegerRequired

to_yearintegerRequired

This endpoint expects an object.

datalist of objectsRequired

to_student_status_idinteger or nullOptional

from_year_student_status_idinteger or nullOptional

Student advancement completed successfully.

statusstringOptional

messagestringOptional

datalist of anyOptional

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X POST https://ssuccessv2.com/app/api/v2/school/structure/advance/2025/2026 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": [
>	{
>	"id": 8,
>	"type": "grade"
>	}
>	]
>	}'