System Settings API

Manages system-wide configuration settings.

Model

{
  "id": "uuid",
  "key": "school_name",
  "value": "International School",
  "category": "general",
  "data_type": "string",
  "description": "School name displayed in headers",
  "is_public": true
}

Categories

Category

Description

general

General school settings

email

Email configuration

attendance

Attendance settings

grading

Grading configuration

canvas

Canvas LMS settings

Endpoints

!!! warning “Permission Required” System settings require SystemSetting permissions.

List Settings

POST /api/system_settings/list

Get Setting

GET /api/system_settings/:id

Create Setting

POST /api/system_settings

Update Setting

PUT /api/system_settings/:id

Delete Setting

DELETE /api/system_settings/:id

Common Settings

Key

Description

school_name

School name

school_logo

Logo URL

default_language

Default UI language

attendance_cutoff_time

Late attendance threshold

grading_scale_id

Default grading scale