Desire2learn D2L Brightspace Valence API

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

★ Only Publicly Available OpenAPI DocumentEducationLmsoauth216 EndpointsREST

For Agents

Install Jentic One Beta

Connect the D2L Brightspace Valence API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the D2L 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 D2L Brightspace Valence 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

GET STARTED

Start building with D2L Brightspace Valence API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use D2L Brightspace Valence 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

Key Endpoints

16 endpoints — jentic publishes the only available openapi specification for d2l brightspace valence api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/lp/1.0/users

Create a new user account

GET

/lp/1.0/users/{userId}

Retrieve a user by ID

POST

/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}

Enroll a user in an organizational unit

DELETE

/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}

Withdraw a user from an organizational unit

GET

/le/1.0/{orgUnitId}/grades

List grade objects for an org unit

PUT

/le/1.0/{orgUnitId}/grades/{gradeObjectId}/values/{userId}

Update a grade value for a user

GET

/le/1.0/{orgUnitId}/content/root

Get root content structure for a course

POST

/lp/1.0/users

Create a new user account

GET

/lp/1.0/users/{userId}

Retrieve a user by ID

POST

/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}

Enroll a user in an organizational unit

DELETE

/lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}

Withdraw a user from an organizational unit

GET

/le/1.0/{orgUnitId}/grades

List grade objects for an org unit

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your D2L Brightspace OAuth token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'update a student grade in Brightspace' or 'enroll a user in a course', and Jentic returns the matching Valence operation with its input schema so the agent calls the right endpoint without navigating D2L's documentation.

Time to first call

FAQs

Specific to using D2L Brightspace Valence 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 with Jentic One, the self-hosted execution layer.

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 your encrypted Jentic One instance, 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.

Can I limit what my agent is allowed to do with the D2L Brightspace Valence API?

Yes. Jentic One is self-hosted by you, so your own rules decide which Valence operations and credentials the agent may use. Because Brightspace puts the org unit and user in the URL path, such as /lp/1.0/enrollments/orgUnits/{orgUnitId}/users/{userId}, you can pin the agent to a single org unit so it manages enrollments and grades within that one course and nothing else. You also choose the specific operations it may call, so destructive actions like withdrawing a user via DELETE stay off limits unless you add them.

Desire2learn D2L Brightspace Valence API

Connect the D2L Brightspace Valence API to your agent

Capabilities

Start building with D2L Brightspace Valence API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs