Docs Valence Desire2learn Brightspace Valence API
★ Only Publicly Available OpenAPI DocumentEducationLmsoauth274 EndpointsREST
For Agents
Manage Brightspace users, courses, enrollments, grades and content on behalf of LMS admins, instructors or SIS sync jobs.
Use for: Provision a new Brightspace user account for an incoming student, List all roles available in the Brightspace org, Enroll a cohort of users into a specific course offering, Reset a user's Brightspace password
Not supported: Does not handle SIS-side records, video lecture hosting, proctoring, or payment processing for course fees — use for Brightspace user, course, enrollment, grade and content operations only.
Jentic publishes the only available OpenAPI specification for Brightspace Valence API, keeping it validated and agent-ready. The Brightspace Valence API is the integration surface for D2L Brightspace, the LMS used by many universities, K-12 districts and corporate training organisations. The 74 endpoints in this spec cover users, profiles, roles, courses, enrollments, grades and content, secured by OAuth2. It suits SIS integrations, automated user provisioning, gradebook export pipelines and any tool that needs to read or write Brightspace learner data.
Install Jentic One Beta
Connect the Brightspace Valence API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Brightspace Valence API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Brightspace Valence API.
Provision and update Brightspace user accounts including names and pronouns
Activate or reset passwords for users in bulk or one at a time
List and assign Brightspace roles for permission management
Create and update course offerings and templates
Enroll learners and instructors into courses
Read gradebook entries and export grades for reporting
Manage course content modules and topics
Use Cases
Patterns agents use Brightspace Valence API for, with concrete tasks.
★ SIS to Brightspace Sync
Universities and districts can keep Brightspace in step with their student information system by reading users and enrollments from the SIS and writing them through the lp/{version}/users and lp/{version}/courses endpoints. Bulk user creation is supported via /lp/{version}/users/batch, which avoids the rate-limit cost of per-user POSTs and shortens the daily sync window.
POST /d2l/api/lp/{version}/users/batch with the day's new student list and POST enrollments for each into the term's course offerings.
Gradebook Export and Reporting
Build a reporting pipeline that pulls grades from Brightspace into a data warehouse for institutional research or accreditation reporting. The grades endpoints expose per-learner grade values that can be aggregated by course, term or cohort. Replaces manual CSV exports from instructor dashboards.
Iterate active course offerings and pull grades per learner via the grades endpoints, writing one row per learner-course-grade triple to the warehouse.
Profile and Identity Management
Centralise updates to learner profiles — names, pronouns, password resets — through Brightspace rather than asking each user to log in. /lp/{version}/users/{userId}/names, /password and /lp/{version}/users/mypronouns let an identity-management workflow keep Brightspace consistent with the source of truth, including recent updates to inclusive name and pronoun fields.
PUT /d2l/api/lp/{version}/users/{userId}/names with the updated preferred-name payload from the identity provider.
AI Agent Academic Operations Assistant
Through Jentic, an AI assistant for an academic-operations team can answer 'who isn't enrolled in the required first-year orientation?' or 'reset Jane's Brightspace password'. The agent searches Jentic for the right Brightspace operation, loads the schema and executes against an admin OAuth token. Frees the registrar's office from routine Brightspace lookups.
Use Jentic to search 'list Brightspace users', load /d2l/api/lp/{version}/users, and execute it filtered by role to flag students missing from a required course.
Key Endpoints
74 endpoints — jentic publishes the only available openapi specification for brightspace valence api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/d2l/api/lp/{version}/users/{userId}
Get a Brightspace user
POST
/d2l/api/lp/{version}/users/batch
Create or update users in batch
GET
/d2l/api/lp/{version}/users/whoami
Get the current authenticated user
GET
/d2l/api/lp/{version}/courses
List course offerings
GET
/d2l/api/lp/{version}/roles
List Brightspace roles
GET
/d2l/api/versions
List supported API versions
GET
/d2l/api/lp/{version}/users/{userId}
Get a Brightspace user
POST
/d2l/api/lp/{version}/users/batch
Create or update users in batch
GET
/d2l/api/lp/{version}/users/whoami
Get the current authenticated user
GET
/d2l/api/lp/{version}/courses
List course offerings
GET
/d2l/api/lp/{version}/roles
List Brightspace roles
GET
/d2l/api/versions
List supported API versions
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Brightspace OAuth client credentials are stored encrypted in the Jentic vault. Agents receive scoped access via Jentic's MAXsystem, so the raw client secret and admin tokens never enter agent context — important for tokens that can write user records.
Intent-based discovery
Agents search by intent (for example 'create Brightspace users in batch' or 'list course offerings') and Jentic returns the matching Valence operations under /d2l/api/lp/{version}/users/batch or /d2l/api/lp/{version}/courses with their schemas, so the agent calls the right endpoint without parsing the Valence reference.
Time to first call
Direct Brightspace Valence integration: 4-7 days for OAuth setup, version negotiation via /d2l/api/versions, batch handling and gradebook quirks. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Brightspace Valence API through Jentic.
Why is there no official OpenAPI spec for Brightspace Valence API?
D2L does not publish an OpenAPI specification for Brightspace Valence. Jentic generates and maintains this spec so that AI agents and developers can call 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 Brightspace Valence API use?
Brightspace Valence uses OAuth2 with admin-level scopes for write operations like provisioning and enrollment. Through Jentic, the OAuth client credentials live in the Jentic vault and the agent receives a scoped token instead of the raw client_id and secret.
Can I create users in batch with the Brightspace Valence API?
Yes. POST /d2l/api/lp/{version}/users/batch accepts an array of user objects in one request, which is the recommended path for SIS sync jobs. This avoids per-user round trips and stays inside Brightspace rate limits during nightly imports.
What are the rate limits for the Brightspace Valence API?
D2L applies per-tenant rate limits that vary by deployment and licensing tier. Production integrations should handle 429 responses with backoff and prefer batch endpoints for large operations rather than tight per-record loops.
How do I list a learner's enrollments through Jentic?
Search Jentic for 'list Brightspace courses for user', load the courses endpoint scoped to a user, and execute with the userId. Through Jentic the OAuth token stays in the vault, so the agent never sees the bearer string in its context.
Can I update a user's preferred name and pronouns with the Valence API?
Yes. /d2l/api/lp/{version}/users/{userId}/names handles preferred name fields, and /d2l/api/lp/{version}/users/mypronouns sets pronoun strings on the current user, which supports inclusive identity workflows.
GET STARTED