Bulk create academic grades

Create multiple academic grade configurations at once for both O-Level and A-Level. Use Cases:

• Initial system setup: Configure all grading scales in one request
• Academic year setup: Define grade boundaries for the new academic year
• Grading system updates: Replace entire grading configuration
• Multi-level configuration: Set up both O-Level and A-Level grades simultaneously Request Structure: The request body should contain two arrays: o_level and a_level. Each array contains grade objects with:
• grade: Grade letter/symbol (e.g., “A”, “B”, “C”, “D”, “F”)
• min_mark: Minimum mark for this grade (0-100)
• max_mark: Maximum mark for this grade (0-100)
• remarks: Optional description/remarks for the grade Validation Rules:
• At least one array (o_level or a_level) must be provided
• Both o_level and a_level must be arrays if provided
• Each grade object must be a valid dictionary
• The level field is automatically added based on the array (“O Level” or “A Level”)
• All standard AcademicSettings validations apply (min_mark < max_mark, no overlaps, etc.) Important Notes:
• This endpoint creates new records; it does NOT update existing grades
• Each grade configuration must have unique mark ranges within its level
• Non-dictionary items in arrays are filtered out automatically
• The endpoint uses the standard AcademicSettingsSerializer validation
• Transaction is atomic - if any grade fails validation, none are created

POST /api/v1/school/academic-settings/bulk-create

Bulk create academic grades

cURL

curl --request POST \
  --url https://api.example.com/api/v1/school/academic-settings/bulk-create/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "grade": "<string>",
  "level": "A Level",
  "min_mark": 50,
  "max_mark": 50,
  "rank": 1,
  "description": "<string>",
  "comment": "<string>",
  "is_deleted": true
}
'

201

SuccessResponse

{ "created": true, "count": 9, "data": [ { "id": "uuid-1", "grade": "A", "level": "O Level", "min_mark": 80, "max_mark": 100, "remarks": "Excellent" }, { "id": "uuid-2", "grade": "B", "level": "O Level", "min_mark": 70, "max_mark": 79, "remarks": "Very Good" } ] }

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Auto-populate created_by from request.user when available.

grade · string | null · required

Maximum string length: 255

level · enum<string> | null · required

• A Level - A Level
• O Level - O Level

Available options: A Level, O Level, , null

min_mark · integer | null · required

Required range: 0 <= x <= 100

max_mark · integer | null · required

Required range: 0 <= x <= 100

rank · integer · default: 1

Required range: 1 <= x <= 2147483647

description · string | null

comment · string | null

is_deleted · boolean

Response

201

application/json

{key} · any