List School Years
Retrieve all school years (academic years) for the current school, ordered by start date descending.Response
Create School Year
Create a new school year (academic year) for the current school.Request Body
List Academic Periods
Retrieve all academic periods (terms/quarters) for the current school, optionally filtered by school year.Query Parameters
Response
Create Academic Period
Create a new academic period within a school year.Request Body
Upload School Media
Upload institutional media files such as logos, images, or documents.Request Body (multipart/form-data)
Response
File Upload Notes
Status Values Reference
School Year Status
| Status | Description |
|---|---|
planning | Year is being planned, not yet active |
active | Currently active academic year |
completed | Year has ended, records finalized |
archived | Archived for historical reference |
Academic Period Status
| Status | Description |
|---|---|
draft | Period planned but not yet started |
active | Currently active period |
closed | Period completed, grades finalized |
archived | Archived for historical reference |
Permissions
| Operation | Required Permission |
|---|---|
| List Years/Periods | read:all, read:grades, or read:schedule |
| Create Year/Period | config:institution or write:all |
| Upload Media | config:institution or write:all |