How to upload data to the MGI using OneRoster API

Students must be integrated into the MGI before they can be added to a test plan. The quickest and most secure method to integrate students is to upload data from your district’s School Information System.

Please note that while most students will be integrated through this data upload, you might occasionally need to add a student on an individual basis.

Overview

1. Clever Secure Sync – Automated data sync for districts using Clever as their SIS integration platform.
2. OneRoster API – Automated data sync from supported SIS platforms such as ClassLink, Infinite Campus, Skyward SMS 2.0, and Synergy.
3. OneRoster CSV – Manual upload via web interface or SFTP integration.

The OneRoster API method of upload is described below. For help with the other two data upload methods, please consult Clever Secure Sync and OneRoster CSV.

District Parameters Settings

You must define your District Parameters Settings before you roster your data through MGI.

These parameters align with the type of Testing Measures you will administer your tests with and the rostering data you provide.

Please review the following sections in the MGI Parameter Settings.

• MGI Student Application Testing Measures (recommended)
• Test Distribution by Class through Screening Class Identification
• All Records Processing

Using OneRoster API

This process is ideal for IT administrators seeking data syncing from their SIS.

Steps to Set Up OneRoster API Integration

1. Confirm SIS Compatibility
   • Ensure your district uses ClassLink, Infinite Campus, Skyward SMS 2.0, or Synergy.
   • Verify that OneRoster API is enabled in your SIS.
2. Request API Credentials
   • Contact your SIS provider or district IT team for API credentials (Client ID, Client Secret, Endpoint, and other possible parameters).
3. Log in to the MGI Application
   • Navigate to Data Integration > Rostering > REST API.
4. Enter API Credentials
   • Input your SIS API credentials and verify the connection by selecting Test Connection.
5. Test and Activate Sync
   • Run a test sync to check data integrity.
   • If there aren’t any issues with your upload, select the Approve option to complete the merge of your data into the MGI.
   • NOTE: To enable continuous updates from your SIS, you may configure an automatic sync schedule. For instructions, proceed to Automatic Data Sync.