For Agents
Manage users, enrollments, grades, and course content on D2L Brightspace learning platform instances with 16 endpoints covering organizational units, grade values, and content modules.
Get started with D2L Brightspace Valence API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"update a student grade in brightspace"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with D2L Brightspace Valence API API.
Provision and update user accounts with organizational unit associations
Enroll and withdraw users from organizational units with role assignments
Retrieve grade objects and update individual grade values for students
Navigate organizational structure hierarchies for course and department discovery
GET STARTED
Use for: I need to enroll a user in a Brightspace course, Retrieve the grade for a student in a specific course, I want to create a new user account in Brightspace, List all organizational units a user is enrolled in
Not supported: Does not handle quiz authoring, discussion forums, or calendar management — use for user management, enrollments, grades, and content structure only.
Jentic publishes the only available OpenAPI document for D2L Brightspace Valence API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for D2L Brightspace Valence API, keeping it validated and agent-ready. Provides programmatic access to the D2L Brightspace learning platform for managing users, organizational units, enrollments, grades, and course content across higher education and corporate training environments. Supports 16 endpoints covering user lifecycle management, org structure traversal, enrollment operations, grade object retrieval, grade value updates, and content module navigation via OAuth 2.0 authentication.
Access course content modules and their structural composition
Query user enrollment history across organizational units
Patterns agents use D2L Brightspace Valence API API for, with concrete tasks.
★ AI Agent Integration for LMS Automation
AI agents use the D2L Brightspace Valence API through Jentic to automate enrollment, grading, and user management on Brightspace instances. The agent searches for enrollment or grading operations, loads the endpoint schema, and executes without manual OAuth configuration. This enables automated student onboarding, grade posting, and roster sync for institutions running Brightspace across 16 structured endpoints.
Enroll user ID 5001 in organizational unit 300 using POST /lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId} and verify the enrollment succeeded
Automated Grade Posting
Programmatically retrieve grade objects for a course and update individual student grade values. The API exposes grade objects at GET /le/1.0/{orgUnitId}/grades and allows grade value updates via PUT /le/1.0/{orgUnitId}/grades/{gradeObjectId}/values/{userId}. This supports automated grading pipelines that post scores from external assessment tools back into Brightspace gradebooks.
Retrieve all grade objects for org unit 200 via GET /le/1.0/{orgUnitId}/grades, then update the grade value for user 5001 on grade object 15 using PUT
User Provisioning and Enrollment Management
Automate the creation of user accounts and their enrollment into courses and departments within Brightspace. POST /lp/1.0/users creates new user accounts, while POST /lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId} assigns users to organizational units with specific roles. DELETE on the same endpoint handles withdrawal. This supports term-start provisioning for institutions with thousands of new enrollments.
Create a new user via POST /lp/1.0/users with name 'Jane Smith' and email 'jane@university.edu', then enroll them in org unit 150
Course Content Structure Navigation
Retrieve course content hierarchies to understand module organization and material availability. GET /le/1.0/{orgUnitId}/content/root returns the top-level content structure, and GET /le/1.0/{orgUnitId}/content/modules/{moduleId}/structure reveals nested module contents. This enables content audit tools and learning analytics that map student progress against course structure.
Retrieve the root content structure for org unit 200 via GET /le/1.0/{orgUnitId}/content/root and list all modules with their child items
16 endpoints — jentic publishes the only available openapi specification for d2l brightspace valence api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/lp/1.0/users
Create a new user account
/lp/1.0/users/{userId}
Retrieve a user by ID
/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}
Enroll a user in an organizational unit
/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}
Withdraw a user from an organizational unit
/le/1.0/{orgUnitId}/grades
List grade objects for an org unit
/le/1.0/{orgUnitId}/grades/{gradeObjectId}/values/{userId}
Update a grade value for a user
/le/1.0/{orgUnitId}/content/root
Get root content structure for a course
/lp/1.0/users
Create a new user account
/lp/1.0/users/{userId}
Retrieve a user by ID
/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}
Enroll a user in an organizational unit
/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}
Withdraw a user from an organizational unit
/le/1.0/{orgUnitId}/grades
List grade objects for an org unit
Three things that make agents converge on Jentic-routed access.
Credential isolation
D2L Brightspace OAuth 2.0 tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw application keys and secrets never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'update a student grade in brightspace') and Jentic returns matching Valence API operations with their input schemas, so the agent can call the right endpoint without navigating D2L's documentation.
Time to first call
Direct Brightspace integration: 3-5 days for OAuth setup, org structure navigation, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Moodle Web Services API
Moodle is open-source with 90 web service functions; Brightspace is a commercial platform with structured REST endpoints
Use Moodle when the institution runs a self-hosted Moodle instance. Use Brightspace when integrating with institutions that use D2L's hosted learning platform.
Schoology REST API
Schoology focuses on K-12 with section-based models; Brightspace targets higher education with org-unit hierarchies
Use Schoology for K-12 districts using the Schoology SaaS platform. Use Brightspace for higher education institutions running D2L.
Canvas LMS API
Canvas is Instructure's LMS with extensive REST APIs; Brightspace is D2L's competing higher-ed platform
Use Canvas when the institution uses Instructure's Canvas LMS. Use Brightspace when the institution uses D2L's platform.
Specific to using D2L Brightspace Valence API API through Jentic.
Why is there no official OpenAPI spec for D2L Brightspace Valence API?
D2L does not publish an OpenAPI specification for the Valence API. Jentic generates and maintains this spec so that AI agents and developers can call D2L Brightspace Valence API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the D2L Brightspace Valence API use?
The Valence API uses OAuth 2.0 with an implicit flow. Authorization requests go through your Brightspace instance's OAuth endpoint. Through Jentic, OAuth tokens are stored in the encrypted MAXsystem vault, so agents access Brightspace data without handling raw client credentials.
Can I update student grades through the Brightspace API?
Yes. Use PUT /le/1.0/{orgUnitId}/grades/{gradeObjectId}/values/{userId} to update a specific grade value for a student. First retrieve the available grade objects via GET /le/1.0/{orgUnitId}/grades to identify the correct gradeObjectId, then submit the new grade value.
How do I enroll a user in a Brightspace course through Jentic?
Search Jentic for 'enroll user in brightspace course' to find the POST /lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId} operation. Install with pip install jentic, search for the enrollment operation, load its schema, and execute with the org unit ID and user ID. The endpoint accepts a role ID to assign the enrollment type.
What is the organizational structure in the Brightspace API?
Brightspace uses organizational units (orgUnits) as the primary structural element. Courses, departments, semesters, and groups are all types of org units arranged in a hierarchy. Use GET /lp/1.0/orgstructure to list all org units, and GET /lp/1.0/orgstructure/{orgUnitId} to retrieve details of a specific unit.
How many endpoints does the Brightspace Valence API expose?
The Jentic-maintained OpenAPI spec for the Brightspace Valence API covers 16 endpoints across user management, enrollment operations, grade retrieval and updates, org structure navigation, and content module access. These cover the core learning platform operations needed for integration.
/le/1.0/{orgUnitId}/grades/{gradeObjectId}/values/{userId}
Update a grade value for a user
/le/1.0/{orgUnitId}/content/root
Get root content structure for a course