Blackboard

Retrieves all messages associated with a specific course in the blackboard learning management system. this endpoint is used to access course-related communication, announcements, and notifications. it provides a comprehensive view of all messages within the context of a particular course, which can include instructor announcements, student discussions, and system notifications. this tool should be used when there's a need to gather all communication related to a specific course, such as for auditing purposes or to provide a complete message history to students or instructors. it does not allow for filtering or searching messages; all messages for the specified course are returned.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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"

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.

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.

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.

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).

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.

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.

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.

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.