Blackboard

Anthology Adopt powered by Pendo allows institutions to gain insights on Blackboard Learn usage and take action through in-app messages, digital walkthrough guides, and tooltips.

314 actions Integration catalog
Request access
Connect Blackboard once you're in Boring.
01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Course Announcements AccessBLACKBOARD_ACCESS_CONTROLLED_COURSE_ANNOUNCEMENTS
Retrieves a list of announcements for a specific course in the Blackboard learning management system. This endpoint allows users to access important messages, updates, or notifications related to a particular course. It should be used when there's a need to fetch all announcements or check for recent updates in a course. The tool returns announcement data but does not provide functionality for creating, updating, or deleting announcements. Keep in mind that the returned list may be paginated if there are many announcements, and additional calls might be necessary to retrieve all data.
Get course announcement by idBLACKBOARD_ACCESS_COURSE_ANNOUNCEMENTS_BASED_ON_PERMISSIONS
Retrieves a specific announcement from a particular course in the Blackboard Learn system. This endpoint allows users to fetch detailed information about a single announcement, including its content, creation date, and any attachments. It is particularly useful for displaying announcement details in external applications or for retrieving updated information about a previously known announcement. The endpoint requires both the course ID and the announcement ID to ensure precise retrieval of the intended announcement. It should be used when specific announcement details are needed, rather than for listing all announcements in a course.
Update child course in parentBLACKBOARD_ADD_CHILD_COURSE
This endpoint updates the relationship between a parent course and its child course in the Blackboard Learning Management System. It is used to modify existing course hierarchies, allowing administrators to restructure course organizations or adjust course relationships. The endpoint should be used when there's a need to change the parent-child association between two courses, such as moving a sub-course to a different parent course or updating the hierarchical structure of courses. It's important to note that this endpoint only modifies existing relationships and does not create new courses or new child-parent associations if they don't already exist in some form.
Upload file to attempt in gradebookBLACKBOARD_ATTACH_FILE
This endpoint allows for the upload and attachment of files to a specific attempt within a course's gradebook in the Blackboard learning management system. It is used to associate submitted work, supporting documents, or any relevant files with a student's attempt on an assignment, quiz, or other assessable items. The endpoint should be called after the initial file upload process, using the generated uploadId to link the file to the specific attempt. It's particularly useful for instructors or system integrators who need to programmatically attach files to student submissions, or for building custom submission interfaces that interact with Blackboard's backend. This endpoint does not handle the actual file transfer; it assumes the file has already been uploaded to Blackboard's system and is now being associated with a specific attempt.
Get oauth2 authorization codeBLACKBOARD_AUTHORIZATION_CODE
Initiates the OAuth 2.0 authorization code flow for the Blackboard API. This endpoint is used to obtain an authorization code, which is a crucial step in the OAuth 2.0 authentication process. The authorization code can later be exchanged for an access token, granting limited access to user resources on the Blackboard platform. This endpoint should be called when an application needs to request permission from a user to access their Blackboard data. It's important to note that this endpoint does not directly provide access to user data; it only initiates the authorization process. The response will typically include a redirect URL containing the authorization code, which the client application must handle appropriately.
Get user gradebook for courseBLACKBOARD_CONDITIONAL_GRADE_ACCESS
Retrieves the gradebook information for a specific user within a particular course in Blackboard. This endpoint allows instructors or authorized personnel to access individual student grade data, including assignment scores, overall course grade, and any custom gradebook columns. It should be used when detailed grade information for a single student in a specific course is needed, such as for progress monitoring or grade reviews. The endpoint does not modify any data and is read-only. Note that this tool only provides grade data and does not include other course or user information beyond what's directly related to the gradebook.
Copy course with specific optionsBLACKBOARD_COPY_COURSE
The CourseCopyTool allows you to create a copy of a Blackboard course with fine-grained control over which elements are included in the copy. This endpoint is used when you need to duplicate a course, either creating a new course or overwriting an existing one, while selectively choosing which components to transfer. It's particularly useful for course administrators or instructors preparing for a new semester or creating variations of an existing course. The tool provides extensive customization options, allowing you to include or exclude specific course elements such as content areas, assessments, gradebook settings, and more. However, it does not handle enrollment of students or instructors in the new course - this must be done separately after the copy is complete.
Copy course by courseidBLACKBOARD_COURSE_AND_ORG_DUPLICATION_PERMISSIONS_UPDATE
This endpoint creates a copy of an existing course in the Blackboard learning management system. It allows instructors or administrators to duplicate course content, settings, and structure into a new or existing course. Use this endpoint when you need to replicate a course for a new semester, create a template from an existing course, or backup course content. The operation copies all copyable elements of the source course into the target course specified by the courseId. Note that this process may take some time for large courses, and certain elements (such as student data or time-sensitive content) may not be copied. The endpoint does not provide real-time progress updates on the copying process.
Create course announcementBLACKBOARD_COURSE_ANNOUNCEMENT_CREATION_PERMISSION
Creates a new announcement within a specified course in the Blackboard learning management system. This endpoint allows instructors or course administrators to post important messages, updates, or notifications to all enrolled students. The announcement can be customized with a title, rich text body using BbML, and specific availability settings. Use this endpoint when you need to communicate course-wide information, such as syllabus changes, assignment reminders, or important dates. The announcement can be created as a draft for later publication or immediately made visible based on the specified availability settings.
Retrieve course listBLACKBOARD_COURSE_DATA_ACCESS_CONTROL_BY_USER_ENTITLEMENT
Retrieves a list of courses from the Blackboard Learn platform. This endpoint allows developers to fetch information about courses available in the learning management system. It can be used to integrate course data into external applications, create custom dashboards, or sync course information with other systems. The endpoint returns read-only data and does not modify any course information. While it provides a comprehensive list of courses, it may not include detailed information about course content, assignments, or student data, which might require additional API calls. Use this endpoint when you need to obtain an overview of courses in the Blackboard Learn environment, such as for course catalogs or administrative purposes.
Course endpoint entitlement accessBLACKBOARD_COURSE_ENDPOINT_ENTITLEMENT_ACCESS
Retrieves detailed information about a specific course in the Blackboard Learn platform using its unique identifier. This endpoint allows users to fetch comprehensive course data, which may include the course name, code, description, enrollment information, instructor details, and other relevant metadata. It's particularly useful for applications that need to display or process course information, such as student portals, administrative tools, or integration with other educational systems. The endpoint should be used when specific course details are required, but it will not provide information about student performance or course content. Note that the exact scope of information returned may depend on the user's permissions within the Blackboard system. name = "course_endpoint_entitlement_access" display_name = "Course Endpoint Entitlement Access"
Retrieve course details by idBLACKBOARD_COURSE_ENTITLEMENT_AND_DATA_ACCESS_CONTROL
Retrieves detailed information about a specific course in the Blackboard Learning Management System. This endpoint allows users to fetch comprehensive data related to a course, such as its title, description, start and end dates, enrollment information, and other course-specific attributes. It is particularly useful for applications that need to display or process course information outside of the Blackboard interface. This tool should be used when detailed course information is required for a known course ID, but it will not provide a list of all courses or modify any course data.
Create course groupBLACKBOARD_COURSE_GROUP_INITIATION
Creates a new group within a specified course in the Blackboard Learn system. This endpoint allows for detailed customization of group properties, including its name, description, availability, and enrollment settings. It's particularly useful for organizing students into smaller units for collaborative work, discussions, or specific course activities. The function supports creating both regular groups and group sets, with options for self-enrollment or instructor-managed membership. Use this when setting up course structures that require student groupings, whether for project teams, study groups, or other collaborative activities within a course.
Update group details by course and group idBLACKBOARD_COURSE_GROUP_MODIFICATION
Updates the properties of a specific group within a Blackboard Learn course. This endpoint allows modification of group details such as name, description, availability, and enrollment settings. It's particularly useful for adjusting group configurations after initial creation, managing student access, and controlling enrollment options. The endpoint supports partial updates, allowing you to modify only the specified fields without affecting others. Use this when you need to change group settings, update availability, or adjust enrollment limits and signup options for an existing group in a course.
Update course information by courseidBLACKBOARD_COURSE_MODIFICATION_PERMISSION_CHECKS
The PatchCourse endpoint allows for updating specific details and settings of an existing course in the Blackboard Learn system. It is used when modifications to course properties such as name, description, availability, enrollment options, or localization settings are needed. This endpoint supports partial updates, meaning only the fields that require changes need to be included in the request body. It's particularly useful for making adjustments to course settings after initial creation or for updating course information based on changes in the academic calendar or institutional policies. However, it's important to note that some settings, like allowing guests or observers, are only modifiable for Classic courses, and certain operations may be restricted when a course is in a closed and complete state.
Update course informationBLACKBOARD_COURSE_MODIFICATION_PERMISSIONS
Updates an existing course in the Blackboard Learn system. This endpoint allows modification of various course attributes including basic information, availability settings, enrollment options, and localization preferences. It's used to adjust course details after initial creation, enabling instructors or administrators to manage course lifecycle and accessibility. The endpoint requires the course ID and accepts a range of optional parameters for fine-tuning course properties. It's particularly useful for making bulk changes to course settings or adapting courses to changing educational needs. Note that some settings, like allowing guests, are only modifiable for specific course types (Classic vs Ultra).
Delete course by courseidBLACKBOARD_COURSE_ORG_SYNC_REMOVAL
Deletes a specific course from the Blackboard Learn platform. This endpoint should be used when an administrator or authorized user needs to permanently remove a course from the system, including all associated content, enrollments, and data. It is particularly useful for cleaning up old or unused courses, or when restructuring the course catalog. Caution should be exercised when using this endpoint, as the deletion is irreversible and will result in the loss of all course-related information. This operation may have significant implications for student records and institutional data, so it should only be used after careful consideration and in compliance with institutional policies.
Create a class courseBLACKBOARD_COURSE_OR_ORGANIZATION_CREATION
Creates a new course in the Blackboard Learn system with specified settings and configurations. This endpoint allows administrators or instructors to set up a course with various parameters including its basic information, availability, enrollment options, and localization settings. It's particularly useful when setting up new courses for an academic term or creating specialized learning environments. The endpoint requires at minimum a course ID and name, but offers extensive customization through optional parameters. It's important to note that some settings, like Ultra status, can significantly impact the course's interface and functionality, so careful consideration should be given when configuring these options.
Delete user from courseBLACKBOARD_COURSE_USER_REMOVAL
Removes a specific user from a particular course in the Blackboard learning management system. This endpoint should be used when an administrator or instructor needs to unenroll a student, remove a teaching assistant, or disassociate any user from a course. It's particularly useful for managing course rosters, handling student withdrawals, or updating staff assignments. The operation is irreversible, so it should be used with caution. This endpoint does not delete the user from the entire Blackboard system; it only removes their association with the specified course. It's important to note that this action may affect the user's access to course materials and their course-related data.
Update user criterion in adaptive ruleBLACKBOARD_CREATE_ADAPTIVE_RELEASE_ACL_USER_PREDICATE
This endpoint updates a user-specific criterion within an adaptive release rule for a particular content item in a Blackboard course. It allows for fine-tuning of content visibility based on individual user conditions. Use this endpoint when you need to modify existing user-based criteria for adaptive release rules, such as changing performance thresholds or adjusting access conditions for a specific student. This tool is specifically for updating existing criteria and should not be used for creating new rules or criteria. Note that this endpoint focuses solely on user-specific criteria and does not handle group-based or date-based release conditions.
Create adaptive release criteria by ruleBLACKBOARD_CREATE_ADAPTIVE_RELEASE_RULE_CRITERIA
This endpoint allows for the creation of new adaptive release criteria for a specific rule within a course's content in Blackboard. It is used to define conditions under which course content will be made available to students, such as completion of prerequisites, achievement of certain grades, or specific dates. The endpoint should be used when instructors or course designers want to implement or modify conditional access to course materials. It's important to note that this endpoint only creates criteria for existing adaptive release rules and does not create the rules themselves.
Create system announcementBLACKBOARD_CREATE_ANNOUNCEMENT
Creates a new system-wide announcement in the Blackboard Learn environment. This endpoint allows administrators to compose and configure announcements that can be displayed to users across the platform. The announcement can be customized with rich text content, specific visibility durations, and display locations such as the login page or within courses. Use this endpoint when you need to broadcast important information, updates, or alerts to all users or specific segments of your Blackboard Learn community. It's particularly useful for system-wide notifications, maintenance alerts, or important institutional announcements. Note that creating excessive or irrelevant announcements may lead to information overload for users, so use this feature judiciously.
Create assignment in course contentsBLACKBOARD_CREATE_ASSIGNMENT
Creates a new assignment within a specified Blackboard course. This endpoint allows instructors to set up detailed assignments with customizable settings for availability, grading, and plagiarism detection. It supports rich text instructions using BbML, adaptive release for controlled content visibility, and integration with originality reporting tools. Use this endpoint when you need to programmatically create assignments with specific requirements or to batch create multiple assignments. The endpoint provides extensive customization options but requires careful consideration of parameters to ensure the assignment is set up correctly for student access and evaluation.
Update user meeting attendance statusBLACKBOARD_CREATE_ATTENDANCE_RECORD
Adds a user to a specific meeting within a Blackboard course and sets their attendance status. This endpoint is essential for managing attendance and user participation in course meetings. It allows instructors or authorized users to update a student's attendance record for a particular meeting. The endpoint should be used when recording attendance for course meetings, updating a user's attendance status, or integrating external attendance tracking systems with Blackboard. It provides a way to maintain accurate attendance records, which can be crucial for course management and student engagement tracking.
Create calendar itemsBLACKBOARD_CREATE_CALENDAR_ITEM
This endpoint creates a new calendar item in the Blackboard platform. It allows users to add various types of events, such as course-related activities, personal appointments, or institution-wide events, to specific calendars within the system. The endpoint supports creating one-time events as well as recurring items with customizable recurrence patterns. It also facilitates the integration of Learning Tools Interoperability (LTI) links, enabling the association of external learning tools with calendar items. This endpoint should be used when adding new events or activities to Blackboard calendars, but it cannot be used to modify existing calendar items or to create items for the read-only GradebookColumn type.
Add catalog category by typeBLACKBOARD_CREATE_CATEGORY
Creates a new category in the Blackboard catalog system. This endpoint allows administrators to define and organize content categories within the learning management system. Use this tool to add a new category with specific properties such as title, description, availability, and access restrictions. It's particularly useful for structuring course offerings, organizing resources, or creating custom catalogs within Blackboard. The created category can be set to appear on the front page and can be restricted to specific institutional roles, providing flexible control over content organization and access.
Create child content in courseBLACKBOARD_CREATE_CHILD
Creates a new content item within a specified course and parent content in the Blackboard Learn platform. This endpoint allows for the creation of various types of content, such as documents, external links, folders, and assignments. It provides extensive control over content properties, including title, body, description, availability, and positioning within the course structure. The endpoint supports rich text formatting through BbML and offers features like review status and adaptive release settings. It should be used when adding new materials, resources, or organizational elements to a course. Note that the content type is determined by the contentHandler, and some properties may have different effects depending on the course experience (Classic vs. Ultra).
Add child node in hierarchyBLACKBOARD_CREATE_CHILD_NODE
Creates a new child node within the institutional hierarchy of Blackboard Learn. This endpoint allows administrators to expand and organize the structure of their educational institution by adding new nodes as children of existing ones. It is particularly useful for creating department, faculty, or program-level nodes within a larger institutional framework. The endpoint requires at least a title for the new node and can optionally include an external ID, description, and specific parent ID. Use this when you need to add a new organizational unit or level to your institution's hierarchy in Blackboard.
Submit gradebook attemptBLACKBOARD_CREATE_COLUMN_ATTEMPT
Creates a new attempt for a specific gradebook column in a Blackboard course. This endpoint allows instructors or authorized users to add a new attempt record for a student's assignment or assessment. It can be used to manually enter grades, provide feedback, or update the status of an attempt. The endpoint is particularly useful for managing individual student submissions, entering grades for offline assignments, or updating attempt statuses in bulk. Note that some fields, such as the attemptReceipt, are read-only and will be generated by the system rather than accepted as input.
Post group attempts for gradebook columnBLACKBOARD_CREATE_COLUMN_GROUP_ATTEMPT
The CreateGroupAttempt endpoint allows for the creation or update of a group attempt for a specific gradebook column in a Blackboard Learn course. This tool is essential for managing group submissions, tracking their progress, and facilitating the grading process. It supports various aspects of group work, including submission status tracking, grading, feedback, and metadata management. The endpoint is particularly useful for instructors and course administrators who need to manage group assignments and assessments within the Blackboard learning environment. It provides flexibility in handling different stages of the submission process, from initial attempt to final grading, and supports both regular and Ultra course formats. However, users should be aware that some status options are deprecated and may cause unexpected behavior if used.
Create course content in courseBLACKBOARD_CREATE_CONTENT
Creates new content within a specified Blackboard course. This endpoint allows for the addition of various types of content, including documents, external links, folders, and more, with detailed configuration options. It supports rich text formatting through BbML, hierarchical content structure, and granular control over content availability and accessibility. Use this endpoint when adding new materials, resources, or structural elements to a course. It's particularly useful for bulk content creation or programmatic course setup. Note that while it offers extensive customization, some advanced features may depend on the Blackboard Learn version in use.
Update content group associationBLACKBOARD_CREATE_CONTENT_GROUP
This endpoint updates the association between a specific content item and a group within a Blackboard Learn course. It is used to modify existing content-group relationships, enabling instructors or administrators to manage group-specific content access or visibility. The endpoint requires the course ID, content ID, and group ID to be specified in the URL path, with the content ID and group ID repeated in the request body for confirmation. This operation is particularly useful for customizing content delivery to different student groups or managing group-based learning activities within a course. Note that this endpoint only updates existing associations and cannot create new content or groups.
Create a new courseBLACKBOARD_CREATE_COURSE
Creates a new course in the Blackboard Learn system with specified attributes and settings. This endpoint allows for the detailed configuration of a course, including its basic information, availability, enrollment options, and localization settings. It supports both Classic and Ultra course views and provides flexibility in defining course duration, access control, and integration with external systems. Use this endpoint when setting up a new course or organization within Blackboard, ensuring all required parameters are provided and optional parameters are used as needed to fully customize the course setup.
Create course meetingBLACKBOARD_CREATE_COURSE_MEETING
Creates a new meeting for a specific course within the Blackboard learning management system. This endpoint allows you to schedule and define the details of a course meeting, including its title, description, start and end times, and an optional external link. Use this when you need to add a new meeting or event to a course's calendar or schedule. The created meeting will be associated with the specified course and visible to course participants. This tool is specifically for creating new meetings and cannot be used to update existing ones or retrieve meeting information.
Create data source with external idBLACKBOARD_CREATE_DATA_SOURCE
Creates a new data source in the Blackboard Learn system. This endpoint is used to establish a unique identifier for an external data source, which can then be referenced in other API calls or integrations. It's particularly useful when setting up integrations between Blackboard and external systems, such as Student Information Systems (SIS) or other educational tools. The created data source can be used for various purposes, including batch operations, data synchronization, or as a reference point for imported content. This endpoint should be used when initially setting up a new integration or when a new external system needs to be recognized within Blackboard. It's important to note that the externalId must be unique across all data sources in the Blackboard instance, and once created, it cannot be changed.
Create discussion forum in courseBLACKBOARD_CREATE_DISCUSSION
Creates a new discussion forum within a specified course in the Blackboard Learning Management System. This endpoint allows instructors or course administrators to set up a discussion topic, define its availability, and optionally make it gradable. It's particularly useful for initiating course-related discussions, Q&A sessions, or collaborative learning activities. The endpoint requires a course ID in the path and accepts JSON payload with discussion details. It should be used when setting up new discussion areas for a course, but not for posting individual messages within an existing discussion. Note that while you can set the initial topic message, many properties of the discussion are auto-generated and read-only.
Create lti domain configurationBLACKBOARD_CREATE_DOMAIN_CONFIG
Creates or updates an LTI (Learning Tools Interoperability) domain configuration in Blackboard Learn. This endpoint allows administrators to set up and manage integrations with external learning tools, configuring various aspects such as user data sharing, security settings, and service permissions. It's used when setting up a new LTI tool or modifying an existing integration to control how the tool interacts with Blackboard and what data it can access. The configuration includes options for managing user privacy, tool authentication, and access to Blackboard services like membership and grading.
Add course content attachmentBLACKBOARD_CREATE_FILE_ATTACHMENT
Adds an attachment to a specific content item within a Blackboard Learn course. This endpoint allows developers to programmatically upload and associate files with course materials, enhancing the content available to students. It should be used when integrating external systems with Blackboard Learn to automate the process of adding supplementary materials, documents, or resources to course content. The endpoint requires specifying both the course and the content item to which the attachment will be added, ensuring precise placement of materials within the course structure. Note that this operation likely has size limitations for attachments and may be subject to storage quotas set by the institution's Blackboard Learn administrator.
Add new gradebook column for courseBLACKBOARD_CREATE_GRADE_COLUMN
Creates a new grade column in a course's gradebook within the Blackboard Learn platform. This endpoint allows instructors or administrators to set up various types of grade columns, including manual entry, calculated grades, and those based on student attempts. It supports features such as anonymous grading, external tool integration, and custom formulas for grade calculation. The endpoint is particularly useful when setting up a new assignment or assessment that requires a corresponding grade column in the course gradebook. It should be used to establish the grading structure for a course, but not for entering actual grades (which would be done through a separate endpoint). Note that some features may have version-specific availability, and certain settings (like includeInCalculations) may behave differently between Classic and Ultra courses.
Post grade notation to course gradebookBLACKBOARD_CREATE_GRADE_NOTATION
Creates a new grade notation in the gradebook for a specific course in Blackboard. This endpoint allows instructors or administrators to add custom performance codes and their corresponding descriptions to the grading system. It's particularly useful for implementing non-standard grading schemes or providing additional context to traditional letter or number grades. The created grade notation can then be used when assigning grades to students, offering more nuanced feedback on their performance. This tool should be used when setting up or modifying the grading structure for a course, especially in cases where standard grading notations are insufficient to capture the full range of student performance or special grading circumstances.
Create course gradebook schemaBLACKBOARD_CREATE_GRADE_SCHEMA
Creates a new gradebook schema for a specific course in Blackboard Learn. This endpoint allows instructors or administrators to define custom grading structures tailored to their course needs. It supports various grading scales including percentage, score-based, tabular (letter grades), text-based, and complete/incomplete systems. The created schema can then be applied to assignments and other gradable items within the course. This tool is essential for setting up the grading framework at the beginning of a course or when implementing a new grading strategy. It should be used carefully as it forms the foundation for grade calculations and student grade representations throughout the course.
Create grading period in course gradebookBLACKBOARD_CREATE_GRADING_PERIOD
Creates a new grading period within a specific course's gradebook in the Blackboard Learn system. This endpoint allows instructors or administrators to define and organize temporal segments for grade collection and management. It's particularly useful for structuring the academic year into distinct grading intervals, such as semesters, quarters, or specific assessment periods. The created grading period can be used to associate gradable items (columns) with specific timeframes, facilitating organized grade tracking and reporting. This endpoint should be used when setting up a new course structure or adjusting existing grading timelines. It's important to note that while the endpoint offers flexibility in date handling, careful consideration should be given to the dateMode parameter and its implications on start and end dates.
Create course group in courseBLACKBOARD_CREATE_GROUP
Creates a new group within a specified course in the Blackboard learning management system. This endpoint allows instructors or administrators to set up and configure groups for collaborative work, discussions, or other course-related activities. The function provides extensive customization options for group availability, enrollment methods, and signup processes. It's particularly useful for organizing students into smaller teams for projects, facilitating peer-to-peer learning, or managing course sections. Note that while many parameters are optional, careful configuration is recommended to ensure the group serves its intended purpose within the course structure.
Update user in course groupBLACKBOARD_CREATE_GROUP_MEMBERSHIP
This endpoint updates a user's information within a specific group in a Blackboard course. It allows administrators or instructors to modify user details, roles, or permissions for a particular user in the context of a course group. Use this endpoint when you need to change a user's status, role, or other attributes within a group, such as updating their group membership type or adjusting their group-specific permissions. This operation is specifically for modifying existing user data and should not be used for adding new users to a group or creating new groups. The endpoint requires the course ID, group ID, and user ID to precisely target the user's information in the correct context.
Modify course content adaptive release group criteriaBLACKBOARD_CREATE_GROUP_PREDICATE
This endpoint updates the criteria for a specific group within an adaptive release rule for a particular content item in a Blackboard course. It allows instructors or course administrators to modify how and when course content is made available to different groups of students based on various conditions. Use this endpoint when you need to adjust the release criteria for course materials for a specific student group, such as changing date restrictions, grade requirements, or other access conditions. This operation is crucial for maintaining flexible and personalized learning paths within a course. Note that this endpoint only updates existing criteria and cannot be used to create new adaptive release rules or groups.
Create group setBLACKBOARD_CREATE_GROUP_SET
Creates a new group set within a specified course in the Blackboard Learn platform. This endpoint allows instructors or administrators to set up a structured group of students for collaborative work, discussions, or other course activities. The group set can be configured with various settings controlling its visibility, enrollment method, and description. Use this when you need to organize students into groups for project work, facilitate peer reviews, or create focused discussion spaces within a course. It's particularly useful for larger classes where multiple small groups are needed for effective collaboration and management.
Create group in courseBLACKBOARD_CREATE_GROUP_SET_CHILD
Creates a new group within a specified course group set in the Blackboard Learn platform. This endpoint allows instructors or administrators to set up groups with customizable settings for student collaboration and activities. It provides options for controlling group availability, enrollment methods, and detailed descriptions using BbML formatting. Use this endpoint when you need to create structured student groups within a course, whether for project work, discussions, or other collaborative activities. The created group can be configured for instructor-managed enrollment or student self-enrollment, with optional signup sheets and member visibility settings.
Update course category detailsBLACKBOARD_CREATE_MEMBERSHIP
This endpoint updates an existing course within a specific category in the Blackboard catalog. It allows administrators or authorized users to modify course details such as title, description, or other attributes associated with the course. The endpoint should be used when changes need to be made to a course that is already placed within a category in the catalog structure. It's important to note that this endpoint only updates existing courses and cannot be used to create new courses or move courses between categories. Proper authorization is likely required to perform this operation, as it involves modifying the course catalog.
Post course message with bbml supportBLACKBOARD_CREATE_MESSAGE
Creates a new message within a specific Blackboard course. This endpoint allows users to compose and send messages to course participants, supporting rich text formatting through BbML, file attachments, and flexible recipient management. It's ideal for course announcements, discussions, or direct communication between instructors and students. The endpoint should be used when there's a need to initiate or continue a conversation within the context of a particular course. It provides comprehensive options for message creation, including subject, body content with rich formatting, recipient lists (To, CC, BCC), and file attachments. However, it does not support scheduling messages for future delivery or sending to recipients outside the course context.
Post discussion message replyBLACKBOARD_CREATE_MESSAGE_REPLY
Creates a reply to a specific message within a Blackboard course discussion. This endpoint allows users to contribute to ongoing discussions by posting responses to existing messages. It supports both course-wide and group-specific discussions, with options to control the visibility and state of the reply. The content of the reply must be formatted in BbML (Blackboard Markup Language) for rich text support. Use this endpoint when a user wants to respond to a particular message in a discussion thread, either immediately publishing the reply or saving it as a draft for later review.
Create institutional hierarchy nodeBLACKBOARD_CREATE_NODE
Creates a new node in the institutional hierarchy of Blackboard. This endpoint allows for the addition of organizational elements such as departments, courses, or other structural units within an educational institution's Blackboard system. It is used to build and maintain the hierarchical structure that organizes content and permissions. The endpoint requires a JSON payload with node details and supports optional parameters for flexibility in node creation and positioning within the hierarchy.
Update course primary node associationBLACKBOARD_CREATE_NODE_COURSE_ASSOCIATION
This endpoint updates the association between a specific course and a node in the Blackboard institutional hierarchy. It allows you to set or change whether the specified node is the primary association for the given course. Use this endpoint when you need to modify the primary status of a course-node relationship, such as when restructuring your institution's course organization or correcting misallocations. The endpoint is particularly useful for managing courses that span multiple nodes or departments. Note that this operation only affects the 'primary' status of the association and does not create or delete associations between courses and nodes.
Update institutional hierarchy user nodeBLACKBOARD_CREATE_NODE_USER_ASSOCIATION
Updates a user's information or association within a specific node of the institutional hierarchy in Blackboard. This endpoint is used to modify a user's relationship or details within a particular organizational unit, such as a department, school, or other institutional division. It allows for the management of user data in the context of the institution's structure, enabling administrators to keep user information accurate and up-to-date within the hierarchy. This tool should be used when there's a need to change a user's status, role, or other attributes specific to their position within a certain part of the institution. It's particularly useful for large educational organizations with complex hierarchical structures.
Update user observerBLACKBOARD_CREATE_OBSERVER
Updates the observer relationship between a user and an observer in the Blackboard Learn platform. This endpoint is used to modify existing observer connections, such as changing the level of access or updating the relationship status between a student and a parent/guardian. It should be used when there's a need to adjust the monitoring permissions or details of an established observer relationship. The endpoint doesn't create new observer relationships; it only modifies existing ones. Note that this operation may have implications on privacy settings and data access within the Blackboard environment.
Create new lti placementBLACKBOARD_CREATE_PLACEMENT
Creates a new LTI (Learning Tools Interoperability) placement in the Blackboard Learn system. This endpoint allows integration of external tools and services into the learning management system, enhancing the capabilities and user experience. It supports various types of placements, including content handlers, system tools, and course navigation elements. Use this endpoint when you need to add a new external tool or service to Blackboard Learn, specifying its type, location, and configuration settings. The created placement can be used for various purposes such as content delivery, student engagement, or administrative tasks, depending on the specified type.
Post pronouns detailsBLACKBOARD_CREATE_PRONOUN
Creates a new pronoun entry in the Blackboard Learning Management System. This endpoint is used to add new pronouns to the system's user identity management, supporting inclusive and diverse user representation. It should be used when administrators or authorized users need to introduce new pronoun options for users to select from. The endpoint incorporates an approval workflow, allowing for review of new pronoun entries before they become available for general use. Note that this endpoint only creates the pronoun entry; it does not assign pronouns to specific users or modify existing user profiles.
Post course assessment questionBLACKBOARD_CREATE_QUESTION
This endpoint creates a new question within an existing Blackboard assessment. It supports various question types and allows for customization of content, feedback, and scoring. Use it to build or modify assessments by adding new questions. Note that while many parameters are optional, the 'text' field is required. The question type determines its structure and behavior, but specific configurations may require additional documentation.
Create course rubric with detailsBLACKBOARD_CREATE_RUBRIC
Creates a new rubric for a specific course in Blackboard Learn. This endpoint allows instructors or course designers to define a structured evaluation tool with customizable criteria, performance levels, and scoring methods. The rubric can be used for various assessment types, including assignments, discussions, and projects. It supports different rubric types (Numeric, Percentage, Range-based) to accommodate diverse grading needs. The created rubric can include detailed descriptions for each performance level and criterion, ensuring clear expectations and consistent grading across evaluators. This tool is essential for setting up comprehensive and transparent assessment frameworks within Blackboard courses.
Create rubric association in courseBLACKBOARD_CREATE_RUBRIC_ASSOCIATION
Creates a new association between a rubric and a specific course content item in the Blackboard learning management system. This endpoint allows instructors or course designers to link a rubric to elements such as assignments, discussions, or other gradable items within a course. It's used to establish grading criteria, set visibility options for students, and connect the rubric to the appropriate gradebook column or question. The association can be configured for grading purposes or as an informational guide, with flexible options for when and how students can view the rubric and its evaluation. This tool is essential for implementing consistent assessment strategies across course content and providing clear expectations to students.
Create rubric evaluation for courseBLACKBOARD_CREATE_RUBRIC_EVALUATIONS
Creates or updates a rubric evaluation for a specific course, rubric, and rubric association in the Blackboard Learn platform. This endpoint allows instructors or authorized users to submit detailed evaluations of student work using predefined rubrics. It supports various types of rubrics (Numeric, Numeric Range, Percentage, Percentage Range) and allows for granular scoring and feedback at the cell level. The evaluation can be associated with individual, group, or question attempts, providing flexibility for different assessment scenarios. Use this endpoint when you need to programmatically submit or modify rubric-based evaluations, such as grading assignments or providing structured feedback on assessments.
Showing the first 60 of 314 actions.