This article outlines the data Brisk Teaching needs from your district to set up and maintain rostering. Whether you're connecting via ClassLink, API, or SFTP, these requirements apply across all methods.
File Format
Brisk supports the OneRoster 1.1 and 1.2 standard file formats. We encourage districts to share the full OneRoster export whenever possible — this gives us the most flexibility as Brisk adds new features that may use additional data fields.
That said, we understand that a full export isn't always feasible. We offer simplified templates that include only the required fields for two common scenarios:
If your SIS cannot export in OneRoster format at all, reach out to rostering@briskteaching.com and we'll work with you to find a solution.
Roster Template File Guide
The sections below walk through every column in the Brisk roster template. If you're using the full OneRoster export from your SIS, the same fields apply — this guide will help you verify that the right data is being sent.
Organizations File
This file tells Brisk which schools are in your roster. Include your district and add the parentID field if you are including district-level administrators.
If a new school is added to your district after the initial roster integration, please let us know by emailing rostering@briskteaching.com. We'll need to make sure the new school is properly mapped in our system before its users can be provisioned.
| Column | Required? | What to Enter | Example |
|---|---|---|---|
| sourcedId | ✅ Required | A unique identifier for the school or district. This can be any ID your SIS uses — it just needs to be consistent. | school-001 |
| name | ✅ Required | The full name of the school or district. | Lincoln Elementary |
| type | ✅ Required | Either school or district. |
school |
| parentId | ⭐ Recommended | The sourcedId of the parent organization. For schools, this should be the sourcedId of the district. For the district itself, leave this blank. | district-01 |
Users File
This file lists every person who should have access to Brisk. This includes teachers, administrators, students, and any other staff.
Users with the administrator role will have access to the site dashboard, where they can review usage data for their assigned school or district.
| Column | Required? | What to Enter | Example |
|---|---|---|---|
| sourcedId | ✅ Required | A unique identifier for the user. This can be any ID your SIS assigns — it just needs to be unique per person. | user-4521 |
| orgSourcedIds | ✅ Required | The sourcedId of the school(s) this user belongs to. This should match a sourcedId from your organizations file. | school-001 |
| role | ✅ Required | The user's role. Use teacher, administrator, student, aide, or staff. |
teacher |
| givenName | ✅ Required | The user's first name. | Maria |
| familyName | ✅ Required | The user's last name. | Garcia |
| ✅ Required | The email address the user will use to sign in to Brisk. | mgarcia@lincoln.edu |
Classes File
This file defines the classes or sections at each school. Including this file is highly recommended — Brisk uses the grade and subject fields to populate the site dashboard for administrators.
| Column | Required? | What to Enter | Example |
|---|---|---|---|
| sourcedId | ✅ Required | A unique identifier for the class. | class-301 |
| title | ✅ Required | The name of the class as it appears in your SIS. | 3rd Grade Math - Period 2 |
| orgSourcedId | ✅ Required | The sourcedId of the school this class belongs to. This should match a sourcedId from your organizations file. | school-001 |
| grades | ⭐ Recommended | The grade level(s) for this class. Use standard values like KG, 01, 02, ... 12. If a class spans multiple grades, separate them with commas. |
03 |
| subjects | ⭐ Recommended | The subject area for this class. Use descriptive values like Math, English Language Arts, Science, etc. |
Math |
💡 If grade and subject data are not included, Brisk will fall back on self-reported data from teachers' onboarding flow.
Enrollments File
This file connects users to their classes. Each row represents one user enrolled in one class.
| Column | Required? | What to Enter | Example |
|---|---|---|---|
| sourcedId | ✅ Required | A unique identifier for this enrollment record. | enr-8821 |
| classSourcedId | ✅ Required | The sourcedId of the class. This should match a sourcedId from your classes file. | class-301 |
| userSourcedId | ✅ Required | The sourcedId of the user being enrolled. This should match a sourcedId from your users file. | user-4521 |
| role | ✅ Required | The user's role in this class — either teacher or student. |
teacher |