Schulportal Hessen API
Auto-generated documentation from the live API schema
Agents
GET
/.well-known/oauth-authorization-server
Authorization Metadata
public
GET
/.well-known/oauth-protected-resource
Resource Metadata
public
GET
/.well-known/oauth-protected-resource/mcp
Resource Metadata
public
GET
/agents
List Agents
public
GET
/agents/authorization/{request_id}
Authorization Details
public
POST
/agents/authorization/{request_id}
Decide
public
GET
/oauth/authorize
Authorize
public
POST
/oauth/register
Register
public
POST
/oauth/revoke
Revoke Token
public
POST
/oauth/token
Token
public
Authentication
POST
/login
Login Endpoint
public
POST
/logout
Logout Endpoint
auth
Calendar
GET
/kalender
Get Calendar Overview
auth
GET
/kalender/event/{event_id}
Get Calendar Event
auth
GET
/kalender/events
Get Calendar Events
auth
Courses
GET
/meinunterricht
Meinunterricht Overview
auth
GET
/meinunterricht/attendance
Meinunterricht Attendance
auth
GET
/meinunterricht/course/{course_id}
Meinunterricht Course
auth
GET
/meinunterricht/entry
Meinunterricht Entry
auth
GET
/meinunterricht/file/{file_hash}
Meinunterricht File
auth
POST
/meinunterricht/homework-done
Meinunterricht Homework Done
auth
GET
/meinunterricht/submissions
Meinunterricht Submissions
auth
GET
/meinunterricht/submissions/file/{file_ref}
Meinunterricht Submission File
auth
POST
/meinunterricht/submissions/upload
Meinunterricht Submission Upload
auth
GET
/meinunterricht/submissions/{detail_ref}
Meinunterricht Submission
auth
GET
/meinunterricht/weekly
Meinunterricht Weekly
auth
DSBmobile
POST
/dsb/login
Dsb Login Endpoint
auth
POST
/dsb/plan
Dsb Plan Endpoint
auth
POST
/dsb/plan-urls
Dsb Plan Urls Endpoint
auth
GET
/dsb/school-plan
Get School Dsb Plan
auth
File Distribution
GET
/dateiverteilung
Get Dateiverteilung
auth
GET
/dateiverteilung/file
Download Dateiverteilung File
auth
File Storage
GET
/dateispeicher
Get Dateispeicher
auth
GET
/dateispeicher/file/{file_id}
Download Dateispeicher File
auth
GET
/dateispeicher/search
Search Dateispeicher
auth
Hosted agents
POST
/agents/channels/{channel}/pairing
Create Pairing
public
GET
/agents/{gid}/runs
List Runs
public
GET
/agents/{gid}/schedules
List Schedules
public
POST
/agents/{gid}/schedules
Create Schedule
public
Messages
GET
/nachrichten/headers
Get Message Headers
auth
POST
/nachrichten/mark-read
Mark Read
auth
POST
/nachrichten/reply
Reply Message
auth
GET
/nachrichten/search
Search Recipients
auth
POST
/nachrichten/send
Send Message
auth
GET
/nachrichten/{conversation_id}
Get Conversation
auth
Modules & Apps
GET
/apps
Get Apps
auth
GET
/modules
Get Modules
auth
Notifications
POST
/notifications/android
Register Android Push
auth
GET
/notifications/android/config
Get Android Notification Config
auth
GET
/notifications/config
Get Notification Config
auth
GET
/notifications/preferences
Get User Notification Preferences
auth
PUT
/notifications/preferences
Update User Notification Preferences
auth
POST
/notifications/subscription
Register Notification Subscription
auth
POST
/notifications/test
Send Notification Test
auth
POST
/notifications/unsubscribe
Unregister Notification Subscription
auth
GET
/notifications/vertretungsplan/options
Get Vertretungsplan Notification Options
auth
Other
POST
/account/deletion/recover
Recover Account Deletion
public
GET
/account/export
Export Account Endpoint
auth
GET
/app/{app_name}
App Launch
auth
POST
/app/{app_name}
App Launch
auth
PUT
/app/{app_name}
App Launch
auth
GET
/app/{app_name}/{path}
App Launch
auth
POST
/app/{app_name}/{path}
App Launch
auth
PUT
/app/{app_name}/{path}
App Launch
auth
POST
/auth/refresh
Refresh Endpoint
public
GET
/cache/status
Cache Status
auth
GET
/dashboard/notifications
Get Dashboard Notification Inbox
auth
POST
/dashboard/notifications/read
Read Dashboard Notifications
auth
POST
/dashboard/notifications/read-all
Read All Dashboard Notifications
auth
POST
/feedback
Submit Feedback
auth
GET
/search/semantic
Semantic Search
auth
GET
/settings/android-beta
Android Beta Status
auth
POST
/settings/android-beta
Android Beta Change
auth
GET
/settings/class-links
Get Class Link Settings
auth
PUT
/settings/class-links
Update Class Link
auth
GET
/settings/preferences
Get Account Preferences
auth
GET
/settings/timetable/lessons
Get Custom Timetable Lessons
auth
PUT
/settings/timetable/lessons
Update Custom Timetable Lesson
auth
GET
/videokonferenz
Get Videokonferenz
auth
GET
/wahlen
Get Wahlen
auth
GET
/wahlen/{election_id}
Get Wahlen Form
auth
POST
/wahlen/{election_id}/submit
Submit Wahlen
auth
POST
/whatsapp/pairing
Create Whatsapp Pairing
auth
PUT
/whatsapp/preferences
Update Whatsapp Preferences
auth
GET
/whatsapp/status
Whatsapp Status
auth
Plans
GET
/stundenplan
Get Stundenplan
auth
GET
/stundenplan/view
Get Timetable View
auth
GET
/vertretungsplan
Get Vertretungsplan
auth
GET
/vertretungsplan/options
Get Vertretungsplan Options
auth
Public status
GET
/status
Public Status
public
GET
/status/image.png
Public Status Image
public
GET
/status/incident/{identifier}
Public Incident
public
School List
GET
/school-list
School List All Cached
public
GET
/school-list/district/{district_id}
School List By District
public
GET
/school-list/search
School List Search
public
Study Groups
GET
/lerngruppen
Get Lerngruppen
auth
System
GET
/health
Health
public
GET
/metrics/stats
Get Metrics Stats
public
User Info
GET
/benutzer
Get User Data
auth
admin
GET
/admin/analytics/accounts/{account_ref}
Analytics Account Lookup
public
GET
/admin/analytics/diagnostics/{diagnostic_id}
Analytics Diagnostic Lookup
public
GET
/admin/analytics/investigate/{account_ref}
Analytics Investigation
public
GET
/admin/analytics/quality
Analytics Quality
public
GET
/admin/analytics/requests/{request_id}
Analytics Request Lookup
public
GET
/admin/analytics/users/{user_id}
Analytics User Investigation
public
GET
/admin/audit
Admin Audit
public
POST
/admin/auth/login
Admin Login
public
GET
/admin/feedback
Admin Feedback
public
GET
/admin/me
Admin Me
public
GET
/admin/metrics/analytics
Admin Metrics Analytics
public
GET
/admin/metrics/overview
Admin Metrics Overview
public
GET
/admin/metrics/schools/map
Admin Metrics Schools Map
public
GET
/admin/schools/{school_id}
Admin School Detail
public
GET
/admin/uptime
Admin Uptime
public
POST
/admin/uptime/check
Admin Uptime Check
public
GET
/admin/users
Admin Users
public
GET
/admin/users/{user_id}
Admin User Detail
public
analytics
POST
/analytics/diagnostics
Diagnostics
auth
GET
/analytics/identity
Identity
auth
homepage
GET
/homepage/user-map
Homepage User Map
public
school pages
GET
/schools
List Schools
public
GET
/schools/{school_id}/campus
Get School Campus
public
GET
/schools/{school_id}/data
Get School Data
public
GET
/schools/{school_id}/logo
Get School Logo
public