Execute Promotion

POST

/classes/promotion

Requires authenticated session. Requires manage:class permission.

Request

Authorization

API Key

Add parameter in cookie

core.session_token

Example:

core.session_token: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Body

🟠400bad-request

🟠401unauthorized

🟠403forbidden

🔴500server-error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/classes/promotion' \
--header 'Content-Type: application/json' \
--data-raw '{
    "targetAcademicYear": "string",
    "transfers": [
        {
            "sourceClassId": "string",
            "targetClassId": "string",
            "studentIds": [
                "string"
            ],
            "enrollmentType": "PROMOTED"
        }
    ],
    "graduated": [
        "string"
    ]
}'

Response Example

201 - Example 1

{
    "success": true,
    "message": "string",
    "meta": {
        "page": 0,
        "limit": 0,
        "total": 0
    },
    "errors": [
        {
            "code": "string",
            "field": "string",
            "message": "string"
        }
    ],
    "result": {
        "moved": 0,
        "repeated": 0,
        "graduated": 0
    }
}

Modified at 2026-05-01 04:13:11

Batch Create Classes

Get Promotion Sources