Skip to main content
Server path: /blackboard-courses | Type: Application | PCID required: Yes

Tools

ToolDescription
blackboard_courses_delete_learn_api_public_catalog_categories_by_categorytype_by_categoryidDelete Category
blackboard_courses_delete_learn_api_public_catalog_categories_by_categorytype_by_categoryid_courses_by_courseidDelete Membership
blackboard_courses_delete_learn_api_public_courses_by_courseidDelete Course
blackboard_courses_delete_learn_api_public_courses_by_courseid_announcements_by_announcementidDelete Announcement
blackboard_courses_delete_learn_api_public_courses_by_courseid_children_by_childcourseidRemove Child Course
blackboard_courses_get_learn_api_public_catalog_categories_by_categorytypeGet Categories
blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_categoryidGet Category
blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_categoryid_coursesGet Memberships
blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_parentid_childrenGet Child Categories
blackboard_courses_get_learn_api_public_coursesGet Courses
blackboard_courses_get_learn_api_public_courses_by_courseidGet Course
blackboard_courses_get_learn_api_public_courses_by_courseid_announcementsGet Announcements
blackboard_courses_get_learn_api_public_courses_by_courseid_announcements_by_announcementidGet Announcement
blackboard_courses_get_learn_api_public_courses_by_courseid_categoriesGet Memberships
blackboard_courses_get_learn_api_public_courses_by_courseid_childrenGet Course Children
blackboard_courses_get_learn_api_public_courses_by_courseid_children_by_childcourseidGet Child
blackboard_courses_get_learn_api_public_courses_by_courseid_crosslistsetGet Cross List Set
blackboard_courses_get_learn_api_public_courses_by_courseid_tasks_by_taskidGet Task
blackboard_courses_patch_learn_api_public_catalog_categories_by_categorytype_by_categoryidUpdate Category
blackboard_courses_patch_learn_api_public_courses_by_courseidUpdate Course
blackboard_courses_patch_learn_api_public_courses_by_courseid_announcements_by_announcementidUpdate Announcement
blackboard_courses_post_learn_api_public_catalog_categories_by_categorytypeCreate Category
blackboard_courses_post_learn_api_public_coursesCreate Course
blackboard_courses_post_learn_api_public_courses_by_courseid_announcementsCreate Announcement
blackboard_courses_post_learn_api_public_courses_by_courseid_copyCopy Course
blackboard_courses_put_learn_api_public_catalog_categories_by_categorytype_by_categoryid_courses_by_courseidCreate Membership
blackboard_courses_put_learn_api_public_courses_by_courseid_children_by_childcourseidAdd Child Course

blackboard_courses_delete_learn_api_public_catalog_categories_by_categorytype_by_categoryid

Delete Category Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id

blackboard_courses_delete_learn_api_public_catalog_categories_by_categorytype_by_categoryid_courses_by_courseid

Delete Membership Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |

blackboard_courses_delete_learn_api_public_courses_by_courseid

Delete Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
removeFilesbooleanNoWhether to delete course files. Defaults to true.

blackboard_courses_delete_learn_api_public_courses_by_courseid_announcements_by_announcementid

Delete Announcement Parameters:
ParameterTypeRequiredDefaultDescription
announcementIdstringYesAnnouncement Id
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_delete_learn_api_public_courses_by_courseid_children_by_childcourseid

Remove Child Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
childCourseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
separationStylestringNoThe method by which the courses will be separated. Default: CompleteSeparation Since: 3900.4.0 | Type | Description | --------- | --------- | | completeSeparation | Re-enable the child course with enrollments and remove all the child enrollments from the master course. | | enrollmentsInBoth | Re-enable the child course with enrollments but leave all the child enrollments in the master course as well, marking them as unavailable. |

blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype

Get Categories Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
sortstringNoProperties to sort by. This is a comma-delimited list of JSON properties, with an optional “(desc)” suffix to request a descending sort for that property. e.g. “title(desc),start” Supported fields are: - id - categoryId - title - available - created Since: 3700.6.0
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
titlestringNoSearch for categories with titles that contain this value. Since: 3700.8.0
categoryIdstringNoSearch for categories with category IDs that contain this value. Since: 3700.8.0
createdstringNoSearch for categories with a created date relative to this value. Since: 3700.8.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3700.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
dataSourceIdstringNoSearch for categories with a data source id matching this value. Since: 3700.9.0
frontPagebooleanNoSearch for categories with a front page indicator matching this value. Since: 3700.9.0
availablebooleanNoSearch for categories with availability matching this value. Since: 3700.9.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_categoryid

Get Category Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_categoryid_courses

Get Memberships Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
expandstringNoA comma-delimited list of fields to expand as part of the response. Expanded fields may cause additional load time. Supported fields are:<br><ul><li>course</li></ul>

blackboard_courses_get_learn_api_public_catalog_categories_by_categorytype_by_parentid_children

Get Child Categories Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
parentIdstringYesParent Id
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
sortstringNoProperties to sort by. This is a comma-delimited list of JSON properties, with an optional “(desc)” suffix to request a descending sort for that property. e.g. “title(desc),start” Supported fields are: - id - categoryId - title - available - created Since: 3700.6.0
titlestringNoSearch for categories with titles that contain this value. Since: 3700.8.0
categoryIdstringNoSearch for categories with category IDs that contain this value. Since: 3700.8.0
createdstringNoSearch for categories with a created date relative to this value. Since: 3700.8.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3700.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
dataSourceIdstringNoSearch for categories with a data source id matching this value. Since: 3700.9.0
frontPagebooleanNoSearch for categories with a front page indicator matching this value. Since: 3700.9.0
availablebooleanNoSearch for categories with availability matching this value. Since: 3700.9.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses

Get Courses Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
modifiedstringNoSearch for courses with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3500.4.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3500.4.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
courseIdstringNoSearch for courses with courseId properties that contain this value. Since: 3100.0.0
namestringNoSearch for courses with name properties that contain this value. Since: 3100.0.0
descriptionstringNoSearch for courses with description properties that contain this value. Since: 3100.0.0
externalIdstringNoSearch for courses with externalId properties that contain this value. Since: 3100.0.0
createdstringNoSearch for courses with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3100.0.0
allowGuestsbooleanNoSearch for courses which are configured to allow/disallow guest access, based on input. Default: n/a (return courses regardless of guests allowed) Since: 3200.3.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3100.0.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
availability.availablestringNoSearch for courses with availability.available properties that contain this value. Since: 3000.13.0 | Type | Description | --------- | --------- | | Yes | Students may access the course. | | No | Students may not access the course. | | Disabled | Disabled by the SIS. Students may not access the course. Since: 3100.0.0 | | Term | Availability is inherited from the term settings. Requires a termId be set. |
dataSourceIdstringNoSearch for courses with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3100.0.0
termIdstringNoSearch for courses with this termId. This may optionally be the term’s externalId using the syntax “externalId:spring2015”. Since: 3100.0.0
organizationbooleanNoSearch for courses by organization flag. A value of ‘true’ indicates that search results should be limited to only Organizations. A value of ‘false’ indicates results should be limited to Courses. Not setting this field indicates that both Courses and Organizations should be returned. Since: 3100.0.0
sortstringNoProperties to sort by. This is a comma-delimited list of JSON properties, with an optional “(desc)” suffix to request a descending sort for that property. e.g. “name(desc),created” Supported fields are: - courseId - name - externalId - created - modified Since: 3400.8.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses_by_courseid

Get Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses_by_courseid_announcements

Get Announcements Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
createdstringNoSearch for announcements with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3500.3.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. ‘lessThan’ also an accepted value. Since: 3500.3.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for announcements with a modified date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3500.3.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. ‘lessThan’ also an accepted value. Since: 3500.3.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
titlestringNoSearch for announcements with a title like the provided value. Since: 3500.3.0
sortstringNoProperties to sort by. This is a comma-delimited list of JSON properties, with an optional “(desc)” suffix to request a descending sort for that property. e.g. “title(desc),created” Supported fields are: - title - modified Since: 3500.3.0
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses_by_courseid_announcements_by_announcementid

Get Announcement Parameters:
ParameterTypeRequiredDefaultDescription
announcementIdstringYesAnnouncement Id
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses_by_courseid_categories

Get Memberships Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
expandstringNoA comma-delimited list of fields to expand as part of the response. Expanded fields may cause additional load time. Supported fields are:<br><ul><li>category</li></ul>

blackboard_courses_get_learn_api_public_courses_by_courseid_children

Get Course Children Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
expandstringNoA comma-delimited list of fields to expand as part of the response. Expanded fields may cause additional load time. Supported fields are:<br><ul><li>childCourse</li></ul>

blackboard_courses_get_learn_api_public_courses_by_courseid_children_by_childcourseid

Get Child Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
childCourseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
expandstringNoA comma-delimited list of fields to expand as part of the response. Expanded fields may cause additional load time. Supported fields are:<br><ul><li>childCourse</li></ul>

blackboard_courses_get_learn_api_public_courses_by_courseid_crosslistset

Get Cross List Set Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_get_learn_api_public_courses_by_courseid_tasks_by_taskid

Get Task Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
taskIdstringYesTask Id
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_patch_learn_api_public_catalog_categories_by_categorytype_by_categoryid

Update Category Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availablebooleanNoBoolean indicating whether or not the category is available
descriptionstringNoThe description of the category
frontPagebooleanNoBoolean indicating whether or not the category should appear on the catalog front page
institutionRoleIdsstring[]NoThe roles for which this category is available, if category is set to restricted. Not populated for lists of categories, only for individual category
restrictedbooleanNoBoolean indicating whether or not category is available to all roles, or restricted to a specific set of roles.
titlestringNoThe title of category

blackboard_courses_patch_learn_api_public_courses_by_courseid

Update Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
allowGuestsbooleanNoWhether guests (users with the role guest) are allowed access to the course. Defaults to true.
availabilityobjectNoSettings controlling availability of the course to students.
closedCompletebooleanNoThis status does not affect availability of the course for viewing in any way. closedComplete is valid for both Ultra and Classic courses. If an Ultra course is in closedComplete mode, updates are not possible. For a Classic course in closedComplete mode, updates are still possible (through Web UI but not through REST i.e. closed is enforced for original courses when updated through REST the same way Ultra courses are blocked) but new notifications are not generated.
dataSourceIdstringNoThe ID of the data source associated with this course. This may optionally be the data source’s externalId using the syntax “externalId:math101”.
descriptionstringNoThe description of the course.
enrollmentobjectNoSettings controlling how students may enroll in the course.
externalIdstringNoAn optional externally-defined unique ID for the course. Defaults to the courseId. Formerly known as ‘batchUid’.
localeobjectNoSettings controlling localization within the course.
namestringNoThe name of the course.
termIdstringNoThe ID of the term associated to this course. This may optionally be the term’s externalId using the syntax “externalId:spring.2016”.

blackboard_courses_patch_learn_api_public_courses_by_courseid_announcements_by_announcementid

Update Announcement Parameters:
ParameterTypeRequiredDefaultDescription
announcementIdstringYesAnnouncement Id
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoSettings controlling availability of the course to students.
bodystringNoThe message body of the Announcement. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’&gt;here&lt;/a> for more information.
draftbooleanNoAn indication of whether or not the Announcement is in draft status.
titlestringNoThe title of this Announcement.

blackboard_courses_post_learn_api_public_catalog_categories_by_categorytype

Create Category Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availablebooleanYesBoolean indicating whether or not the category is available
categoryIdstringYesThe human-readable id of the category
descriptionstringNoThe description of the category
frontPagebooleanNoBoolean indicating whether or not the category should appear on the catalog front page
institutionRoleIdsstring[]NoThe roles for which this category is available, if category is set to restricted. Not populated for lists of categories, only for individual category
parentIdstringNoThe ID of this category’s parent category
restrictedbooleanNoBoolean indicating whether or not category is available to all roles, or restricted to a specific set of roles.
titlestringYesThe title of category

blackboard_courses_post_learn_api_public_courses

Create Course Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
allowGuestsbooleanNoWhether guests (users with the role guest) are allowed access to the course. Defaults to true.
availabilityobjectNoSettings controlling availability of the course to students.
closedCompletebooleanNoThis status does not affect availability of the course for viewing in any way. closedComplete is valid for both Ultra and Classic courses. If an Ultra course is in closedComplete mode, updates are not possible. For a Classic course in closedComplete mode, updates are still possible (through Web UI but not through REST i.e. closed is enforced for original courses when updated through REST the same way Ultra courses are blocked) but new notifications are not generated.
courseIdstringYesThe Course ID attribute, shown to users in the UI.
dataSourceIdstringNoThe ID of the data source associated with this course. This may optionally be the data source’s externalId using the syntax “externalId:math101”.
descriptionstringNoThe description of the course.
enrollmentobjectNoSettings controlling how students may enroll in the course.
externalIdstringNoAn optional externally-defined unique ID for the course. Defaults to the courseId. Formerly known as ‘batchUid’.
localeobjectNoSettings controlling localization within the course.
namestringYesThe name of the course.
organizationbooleanNoWhether this object represents an Organization. Defaults to false.
termIdstringNoThe ID of the term associated to this course. This may optionally be the term’s externalId using the syntax “externalId:spring.2016”.
ultraStatusstringNoWhether the course is rendered using Classic or Ultra Course View. | Type | Description | --------- | --------- | | Undecided | The ultra status is not decided. | | Classic | The course is decided as classic. | | Ultra | The course is decided as ultra | | UltraPreview | The course is currently in Ultra mode but during the preview state where it may still be reverted via a Restore to the classic state |

blackboard_courses_post_learn_api_public_courses_by_courseid_announcements

Create Announcement Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoSettings controlling availability of the course to students.
bodystringNoThe message body of the Announcement. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’&gt;here&lt;/a> for more information.
draftbooleanNoAn indication of whether or not the Announcement is in draft status.
titlestringYesThe title of this Announcement.

blackboard_courses_post_learn_api_public_courses_by_courseid_copy

Copy Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
copyobjectNoThe options which will be used when copying the specified course
targetCourseobjectYesThe destination course to copy into. This can be either a new course, defined by the courseId field, or an existing course, defined by the id field.

blackboard_courses_put_learn_api_public_catalog_categories_by_categorytype_by_categoryid_courses_by_courseid

Create Membership Parameters:
ParameterTypeRequiredDefaultDescription
categoryTypestringYesCategory Type
categoryIdstringYesCategory Id
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_courses_put_learn_api_public_courses_by_courseid_children_by_childcourseid

Add Child Course Parameters:
ParameterTypeRequiredDefaultDescription
courseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
childCourseIdstringYesThe course or organization ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | externalId | externalId:math101 | | courseId | courseId:math101 | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
ignoreEnrollmentErrorsbooleanNoBy default, enrollment errors encountered during a course merge will result in a 409 CONFLICT response. The ignoreEnrollmentErrors parameter can be sent as true in order to bypass enrollment errors.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.