Bulk update subjects

Perform bulk create, update, and delete operations on subjects. This endpoint handles intelligent synchronization of subjects across O-Level and A-Level. Workflow:

• Creates new subjects that don’t exist (based on subject code)
• Updates existing subjects that match by code
• Deletes subjects not included in the request data Request Format: The request should contain subjects grouped by level:

{
"o_level": [
{"name": "Mathematics", "code": "MATH101", "curriculum": "uuid"},
{"name": "English", "code": "ENG101", "curriculum": "uuid"}
],
"a_level": [
{"name": "Advanced Mathematics", "code": "MATH201", "curriculum": "uuid"}
]
}

Response Format: Returns subjects grouped by level with updated information:

{
"a_level": [...],
"o_level": [...]
}

Important Notes:

• Subject code is used as the unique identifier for updates
• Subjects without codes in the request will be treated as new subjects
• Existing subjects not included in the request will be soft-deleted
• All validations from the serializer apply to each subject

PUT /api/v1/school/subjects/bulk-update

Bulk update subjects

cURL

curl --request PUT \
  --url https://api.example.com/api/v1/school/subjects/bulk-update/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "a_level": [
    {
      "id": "789e4567-e89b-12d3-a456-426614174111",
      "name": "Advanced Mathematics",
      "code": "MATH201",
      "curriculum": "123e4567-e89b-12d3-a456-426614174000",
      "curriculum_details": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "exam_board": "Cambridge"
      },
      "is_deleted": false,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-20T14:45:00Z"
    }
  ],
  "o_level": [
    {
      "id": "789e4567-e89b-12d3-a456-426614174222",
      "name": "Mathematics",
      "code": "MATH101",
      "curriculum": "123e4567-e89b-12d3-a456-426614174000",
      "curriculum_details": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "exam_board": "Cambridge"
      },
      "is_deleted": false,
      "created_at": "2025-01-10T08:00:00Z",
      "updated_at": "2025-01-20T14:45:00Z"
    }
  ]
}

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

{key} · any

Response

200

application/json

{key} · any