Push standards-based grades to a OneRoster 1.2 provider using the assessmentLineItems, scoreScales, and assessmentResults resources.
domain: imsglobal.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Confirm the SIS/gradebook provider implements the OneRoster 1.2 Gradebook service (a separately conformance-tested binding from Rostering) before attempting writes.
Create or reference a scoreScale resource defining the standards-based scale values you'll report against.
PUT an assessmentLineItem tied to a classSourcedId, referencing the scoreScale, distinct from a regular gradebook lineItem.
PUT assessmentResult records per student referencing the assessmentLineItem's sourcedId and studentSourcedId, using the standards-based scale value.
Use the sourcedId in the resource URL path for PUT-based writes, expecting a soft-delete (status=tobedeleted) convention rather than hard DELETE.
Known gotchas
Gradebook write support (SIS-bound direction) is far less commonly implemented by vendors than the roster-pull direction — confirm support first.
assessmentLineItems/assessmentResults are newer 1.2 additions distinct from plain lineItems/results; don't conflate the two resource families.
Score value ranges and pass/fail semantics on the same standardized schema still vary by vendor in practice.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?