Behind the Blackboard! REST API Allows Upper Case String Values and the REST User Search Cannot Search for Upper Case Values - Behind the Blackboard Skip Navigation
Download PDF  Icon Download PDF    Print article

REST API Allows Upper Case String Values and the REST User Search Cannot Search for Upper Case Values

Date Published: Apr 11,2025


CategoryProduct:Blackboard Learn SaaS
Article No.: 000077096
Product:
Learn SaaS
Release:
9.1;SaaS
Description:
The REST API allows Upper case String Values and the REST User Search cannot search for upper case values.
Steps to Repeat:
  1.  Log into Blackboard Learn via REST API
  2.  Create a user via REST.  Note user created via SIS and GUI will all have the text set to lower case. 
  3.  Use POST request to https://clientURL/learn/api/public/v1/users (replace the clientURL for your own URL)

{

"externalId": "J5555",
"dataSourceId": "_2_1",
"userName": "J5555",
"studentId": "J5555",
"educationLevel": "Unknown",
"gender": "Unknown",
"password": "1234",
"name":

{ "given": "andy ", "family": "hulme", "middle": "george", "preferredDisplayName": "GivenName" }

}

Observed Behavior:

"externalId": "J5555",

Use the search

https://clientURL/learn/api/public/v1/users/?externalId=J5555 (replace the clientURL for your own URL)

Empty Array

A direct call will show the information correctly:

https://clientURL/learn/api/public/v1/users/externalId:J5555  (replace the clientURL for your own URL)

Expected Behavior:

The search should either be case-insensitive, REST should set all external Id’s to lower case.

Note: The user "J5555" is not mandatory, it was used just as an example.






Target Release:

Future Reference

Patch Available:

No






The information contained in the Knowledge Base was written and/or verified by Blackboard Support. It is approved for client use. Nothing in the Knowledge Base shall be deemed to modify your license in any way to any Blackboard product. If you have comments, questions, or concerns, please send an email to kb@blackboard.com. © 2025 Blackboard Inc. All rights reserved