Behind the Blackboard! Clearing and Updating a Grade Using REST API Results in an Override Grade Rather than the Attempt Grade - Behind the Blackboard Skip Navigation
Download PDF  Icon Download PDF    Print article

Clearing and Updating a Grade Using REST API Results in an Override Grade Rather than the Attempt Grade

Date Published: Apr 11,2025


CategoryPlanned First Fix Release:Working as Intended; Product:Blackboard Learn SaaS; Version:Ultra
Article No.: 000077675
Product:
Learn SaaS
Release:
SaaS
Service Pack(s):
Ultra
Description:

In the User Interface, when an Instructor clears a grade and adds a new grade in an Original Course Grade Center column, this is considered a normal Attempt Grade and not an Override Grade.  Performing the equivalent actions using REST API causes an Override Grade instead of an Attempt Grade. 

Steps to Repeat:
  1. Log into Blackboard Learn Ultra Experience as an administrator 
  2. Access an Original course and quick enroll as an instructor 
  3. Enroll a Student
  4. Navigate to Control Panel > select Grade Center > select Full Grade Center > click Create Column
  5. Enter a desired Column Name with Points Possible as 100 > select Submit
  6. Select Create Column to create a second column
  7. Enter a desired Column Name for the second column with Points Possible as 100 > select Submit
  8. Using REST API complete the following two requests for the first column
    1. REST API:
      PATCH /learn/api/public/v2/courses/{courseid}/gradebook/columns/{columnid}/users/{userid} -d '{"score":50}'
    2. REST API:
      PATCH /learn/api/public/v2/courses/{courseid}/gradebook/columns/{columnid}/users/{userid} -d '{"score":60}'
  9. In the User Interface select Grade Center > select the first Column > select View Grade Details > select Clear Attempt
  10. Using REST API complete the following request for the first Column
    • REST API:
      PATCH /learn/api/public/v2/courses/{courseid}/gradebook/columns/{columnid}/users/{userid} -d '{"score":50}'
  11. In the User Interface select Grade Center > select the first Column > select View Grade Details > select Grade History
  12. Observe the last grade entered is listed as "50.00 out of 100 points Original grade has been overridden" while the first grades are listed as Attempt Grade
  13. Navigate to Grade Center > select the second Column > select View Grade Details
  14. Set Current Grade Value as 50 > select Save
  15. Click Edit Grade
  16. Set Current Grade Value as 60 > select Save
  17. Click Clear Attempt
  18. Set Current Grade Value as 50 > select Save
  19. Navigate to Grade History


Observed Behavior:
The final Grade entered in the User Interface is considered a normal Attempt Grade, REST API considers the final Grade as an Override Grade. 

Expected Behavior:
The experience when using the User Interface and REST API to create and update Grades should be consistent.

 





Target Release:

Functioning as Designed







The information contained in the Knowledge Base was written and/or verified by Blackboard Support. It is approved for client use. Nothing in the Knowledge Base shall be deemed to modify your license in any way to any Blackboard product. If you have comments, questions, or concerns, please send an email to kb@blackboard.com. © 2025 Blackboard Inc. All rights reserved