Behind the Blackboard! Ultra Courses and the REST API Display LTI Tools that are Turned off by Institutional Hierarchy - Behind the Blackboard Skip Navigation
Download PDF Icon Download PDF    Print article

Ultra Courses and the REST API Display LTI Tools that are Turned off by Institutional Hierarchy

Date Published: Apr 11,2025


CategoryProduct:Blackboard Learn SaaS
Article No.: 000058246
Product:
Learn SaaS
Release:
SaaS
Description:
When an LTI tool is turned off only at the Institutional Hierarchy Node level, Ultra Courses Associated with the Node still display the tool in the "Books & Tools" menu. The REST API endpoint for LTI placements still lists it as available without qualification.
Steps to Repeat:
  1. Log into Blackboard Learn (SaaS environment) as System Administrator
  2. Navigate to System Admin > Institutional Hierarchy > Create Node
  3. Add a Node
  4. Go to System Admin > Courses > Create an Ultra Experience Course
  5. Add this course to the Node
  6. Create an LTI Tool Provider Course Tool Placement or reuse an existing one
  7. Go to System Admin > Institutional Hierarchy > the node you created > Tools
  8. Set this LTI Tool to OFF and apply to existing Courses
  9. After the asynchronous job to update the existing course completes go to the Course
  10. Select View Institution Course & Tools 
  11. The Books & Course Tools peek menu appears
Expected Behavior:
The tool does not appear in the menu.

Observed Behavior:
The tool appears in the menu.

Symptoms:

There is no way to restrict LTI tool availability by Institutional Hierarchy in Ultra Experience Courses.  REST applications that use LTI Placements may be able to detect Placements that cannot actually be used in certain contexts.

Cause:

The REST API endpoint /learn/api/public/v1/lti/placements reflects the system-level availability.  The Ultra User Interface calls this API to enumerate available LTI Placements.



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