Create academic grade

Create a single academic grade configuration. Use Cases:

• Add a new grade to existing grading system
• Create individual grade after initial setup
• Define custom grade with specific mark ranges Request Structure: The request body should contain:
• grade: Grade letter/symbol (e.g., “A”, “B”, “C”, “1”, “2”, etc.) - Required
• level: Academic level - either “O Level” or “A Level” - Required
• min_mark: Minimum mark for this grade (0-100) - Required
• max_mark: Maximum mark for this grade (0-100) - Required
• remarks: Optional description or remarks for the grade Validation Rules:
• min_mark must be less than max_mark
• Mark ranges must not overlap with existing grades for the same level
• Grade value must be unique within the same level
• Marks must be between 0 and 100 Important Notes:
• For bulk creation of multiple grades, use the /bulk-create endpoint instead
• Each level (O-Level/A-Level) should have complete grade coverage from 0 to 100
• Grade names are case-sensitive

POST /api/v1/school/academic-settings

Create academic grade

cURL

curl --request POST \
  --url https://api.example.com/api/v1/school/academic-settings/ \
  --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,
  "data": {
    "id": "uuid-123",
    "grade": "A",
    "level": "O Level",
    "min_mark": 80,
    "max_mark": 100,
    "remarks": "Excellent performance"
  }
}

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