Docs Valence Desire2learn Brightspace Valence API

Name: Brightspace Valence API
Brand: Brightspace Valence API
Availability: InStock

★ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Brightspace Valence API

Explore with Jentic

View OpenAPI Document

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.

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

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.

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.