API to Retrieve and Update User's AOU/Department Level Role in Brightspace?

Question

Is there an API in Brightspace that allows me to retrieve a user's role at the AOU (Authorised Operating Unit) or department level? Additionally, is there an API that allows updating a user's role at the AOU/department level? If so, could you please provide the endpoint details and any relevant documentation?

Best regards,

Kabir

Kabir.H.527 · Answer

Hi Tauany,

Thank you for your reply. You can ignore my earlier question about the hardcoded values for {orgUnitId} and {userId} in the fetch URL. I’ve resolved the issue.

The problem was that the hardcoded values were coming from outside my code specifically from the org unit where my widget was located. To fix it, I simply renamed the {orgUnitId} and {userId} variables throughout my code to different names, and everything started working perfectly.

Best regards,

Kabir

Tauany.S.691 · Answer

Hi Kabir,

Thank you for your question. To help us better understand the issue you are experiencing, could you please confirm whether you are receiving an error message from the API call or if the issue you are currently facing is only related to the fact that the code keeps reverting to the hardcoded values?

Thank you,

Tauany

Kabir.H.527 · Answer

Hi Matt,

Thank you for your help. Now my custom widget is ready, but in my custom widget, I have a function to check the user role before enrolling a user, but it’s not working as expected. The reason appears to be hardcoded values for {orgUnitId} and {userId} in the fetch URL.

For example, the problematic line looks like this:

const res = await fetch(`${API}/enrollments/orgUnits/$123456/users/$789101`, {

I replaced the hardcoded values with template literals using variables:

const res = await fetch(`${API}/enrollments/orgUnits/${orgUnitId}/users/${userId}`, {

However, the code keeps reverting to the hardcoded values. Note that the hardcoded orgUnit value corresponds to the org unit where my widget currently runs, and the hardcoded userId corresponds to my user ID.

I have tried the following troubleshooting steps without any improvement:

* Reverting the fetch line back to use the variables:
* const res = await fetch(`${API}/enrollments/orgUnits/${orgUnitId}/users/${userId}`, {
* Performing a hard-refresh in the browser:* Windows: Ctrl + F5

* In Dev Tools → Network tab, checking Disable cache and then reloading
* Deleting the old HTML content and replacing it with the updated file containing the correct getEnrollment() code

Here is the function I am using:

async function getEnrollment(orgUnitId, userId) {

try {

const res = await fetch(`${API}/enrollments/orgUnits/${orgUnitId}/users/${userId}`, { headers: HEADERS });

if (res.status === 404) return null;

if (!res.ok) throw new Error(`Failed to check enrollment: ${res.status}`);

return await res.json(); // Full response with RoleId

} catch (err) {

console.error(`Enrollment check failed for user ${userId} in ${orgUnitId}:`, err);

return null;

}

Despite all the above, the hardcoded values keep reappearing in the code, which is breaking the enrollment check.

Could you please advise what might be causing this issue and how to fix it?

Best regards,

Kabir