Retrieve and delete course completion records for a Brightspace org unit via the Valence Grades API
domain: education · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain an access token with read access to the org unit's grades resource.
GET /d2l/api/le/{version}/{orgUnitId}/grades/courseCompletion/ to list Grade.CourseCompletion records, each containing OrgUnitId, CompletionId, UserId, CompletedDate, and an optional ExpiryDate.
Narrow the list with the optional userId, startExpiry, and endExpiry query parameters, and follow the returned bookmark to page through large result sets.
To retire a stale or incorrect completion record, call DELETE /d2l/api/le/{version}/{orgUnitId}/grades/courseCompletion/{completionId}.
Handle 403 responses (no permission to view/delete course completions in that org unit) and 404 (no such completion record for that org unit/ID).
Known gotchas
ExpiryDate is optional — a null value means the completion never expires, so don't assume every record matched by startExpiry/endExpiry filtering necessarily has one set.
The DELETE action permanently removes the completion record; this resource offers no soft-delete or restore option.
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?