Assigning Exams
After configuring an exam, you need to assign it to the students who should take it. BeamEdUp supports assignment at multiple levels — individual students, classes, or branches. Assignments are managed via the /exams/:id/assign endpoint.
Assignment Types
The assignment system supports two assignee types:
- Class Assignment — Assign the exam to an entire class. All students enrolled in that class receive the exam on their dashboard. New students added to the class after assignment also gain access.
- Individual Assignment — Assign the exam to specific students by name or ID. Useful for makeup exams, special accommodations, or targeted assessments.
Assigning to Classes
1
Open the Exam Detail Page
Navigate to Exams and click on the exam you want to assign.
2
Click "Assign" from the Action Menu
Open the action menu (three dots) and select "Assign", or navigate to the Assign tab on the exam detail page.
3
Select Assignment Type
Choose "Classes" to assign to entire classes. The class selection panel appears with your organization's classes.
4
Choose Classes
Use the multi-select dropdown to pick one or more classes. Each class card shows the class name and code.
5
Enable Notifications
Check "Send notifications to students" to alert students about the new assignment via the notification system.
6
Confirm Assignment
Click "Assign" to complete. The assignment table updates to show the new entries with type, assignee, and date.
Assignment Fields
| Field | Required | Type | Description |
|---|---|---|---|
Assignee Type | Required | select | Choose between "class" to assign to an entire class or "user" to assign to individual students. |
Assignee ID | Required | select | The class or student to assign the exam to. Select from the dropdown list populated by your organization data. |
Due Date | Optional | datetime | Optional deadline specific to this assignment. Overrides the exam schedule end date for this assignee. |
Assigning to Individual Students
To assign to individual students, select "Individual Students" as the assignment type. A student search panel appears where you can search by name or email and select specific students. This is useful when:
- A student needs a makeup exam
- You want to test with a small group before publishing broadly
- Specific students require a different exam variant
- Students from different classes need the same assessment
Branch-Level Assignment
If your exam is scoped to a specific branch (set during exam creation via the branchId field), only classes and students within that branch appear in the assignment options. Organization-wide exams (no branch specified) can be assigned to any class or student across all branches.
Assignment Notifications
When the "Send notifications" checkbox is enabled during assignment, students receive a notification about the newly assigned exam. The notification includes the exam title, due date (if set), and a link to view the exam details on their dashboard.