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

Tools

ToolDescription
blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_by_groupidDelete Group
blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_useridDelete Group Membership
blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_sets_by_groupidDelete Group Set
blackboard_groups_delete_learn_api_public_courses_by_courseid_messages_by_messageidDelete Message
blackboard_groups_delete_learn_api_public_courses_by_courseid_users_by_useridDelete Membership
blackboard_groups_get_learn_api_public_courses_by_courseid_groupsGet Groups
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupidGet Group
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupid_usersGet Group Memberships
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_useridGet Group Membership
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_setsGet Group Sets
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_sets_by_groupidGet Group Set
blackboard_groups_get_learn_api_public_courses_by_courseid_groups_sets_by_groupid_groupsGet Group Set Children
blackboard_groups_get_learn_api_public_courses_by_courseid_messagesGet Messages
blackboard_groups_get_learn_api_public_courses_by_courseid_messages_by_messageid_participantsGet Message Participants
blackboard_groups_get_learn_api_public_courses_by_courseid_messages_foldersGet Folders
blackboard_groups_get_learn_api_public_courses_by_courseid_usersGet Course Memberships
blackboard_groups_get_learn_api_public_courses_by_courseid_users_by_useridGet Membership
blackboard_groups_get_learn_api_public_users_by_userid_coursesGet User Memberships
blackboard_groups_patch_learn_api_public_courses_by_courseid_groups_by_groupidUpdate Group
blackboard_groups_patch_learn_api_public_courses_by_courseid_groups_sets_by_groupidUpdate Group Set
blackboard_groups_patch_learn_api_public_courses_by_courseid_messages_by_messageidUpdate Message
blackboard_groups_patch_learn_api_public_courses_by_courseid_users_by_useridUpdate Membership
blackboard_groups_post_learn_api_public_courses_by_courseid_groupsCreate Group
blackboard_groups_post_learn_api_public_courses_by_courseid_groups_setsCreate Group Set
blackboard_groups_post_learn_api_public_courses_by_courseid_groups_sets_by_groupid_groupsCreate Group Set Child
blackboard_groups_post_learn_api_public_courses_by_courseid_messagesCreate Message
blackboard_groups_put_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_useridCreate Group Membership
blackboard_groups_put_learn_api_public_courses_by_courseid_users_by_useridCreate Membership

blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_by_groupid

Delete Group Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesThe group 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:breakfastClub |
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_groups_delete_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_userid

Delete Group Membership 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 |
groupIdstringYesThe group 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:breakfastClub |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |

blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_sets_by_groupid

Delete Group 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 |
groupIdstringYesThe group 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:breakfastClub |

blackboard_groups_delete_learn_api_public_courses_by_courseid_messages_by_messageid

Delete Message 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 |
messageIdstringYesMessage Id
folderTypestringNoSpecifies the folder type, The default type is inbox | Type | Description | --------- | --------- | | Inbox | | | Sent | | | Delete | | | Custom | |
folderNamestringNoSpecifies the folder name of the custom folder

blackboard_groups_delete_learn_api_public_courses_by_courseid_users_by_userid

Delete Membership 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 |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |

blackboard_groups_get_learn_api_public_courses_by_courseid_groups

Get Groups 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.
namestringNoThe group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0
nameComparestringNoUsed alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | |
inGroupSetbooleanNoIndicates whether only groups in a GroupSet (or groups NOT in a GroupSet) should be included Since: 3900.10.0
createdstringNoSearch for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
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)” Supported fields are: - name - externalId Since: 3100.4.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupid

Get Group 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 |
groupIdstringYesThe group 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:breakfastClub |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupid_users

Get Group Memberships Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesThe group 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:breakfastClub |
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>user</li></ul>

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_userid

Get Group Membership 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 |
groupIdstringYesThe group 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:breakfastClub |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_sets

Get Group Sets 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 |
namestringNoThe group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0
nameComparestringNoUsed alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | |
createdstringNoSearch for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
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. “name(desc)” Supported fields are: - name - externalId Since: 3100.4.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_sets_by_groupid

Get Group 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 |
groupIdstringYesThe group 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:breakfastClub |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_get_learn_api_public_courses_by_courseid_groups_sets_by_groupid_groups

Get Group Set Children Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesThe group 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:breakfastClub |
namestringNoThe group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0
nameComparestringNoUsed alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | |
createdstringNoSearch for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
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. “name(desc)” Supported fields are: - name - externalId Since: 3100.4.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_groups_get_learn_api_public_courses_by_courseid_messages

Get Messages 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 |
folderTypestringNoSpecifies the folder type, The default type is inbox | Type | Description | --------- | --------- | | Inbox | | | Sent | | | Delete | | | Custom | |
folderNamestringNoSpecifies the folder name of the custom folder
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. “isRead(desc),start” Supported fields are: - isRead - postedDate Since: 3900.2.0
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>sender</li></ul>

blackboard_groups_get_learn_api_public_courses_by_courseid_messages_by_messageid_participants

Get Message Participants 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 |
messageIdstringYesMessage 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.
participationTypestringNoSearch the participation type Since: 3800.20.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. “PARTICIPATION_TYPE(desc),start” Supported fields are: - participationType Since: 3900.2.0
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>user</li></ul>

blackboard_groups_get_learn_api_public_courses_by_courseid_messages_folders

Get Folders 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.

blackboard_groups_get_learn_api_public_courses_by_courseid_users

Get Course 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.
rolestringNoSearch for memberships with a course role id that matches this value. Since: 3500.5.0
createdstringNoSearch for memberships with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3100.0.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3100.0.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for memberships with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.9.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3800.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
dataSourceIdstringNoSearch for memberships with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3100.0.0
lastAccessedstringNoSearch for memberships with a last accessed date relative to this value. ‘lastAccessedCompare’ may also be sent to control search behavior. Since: 3300.9.0
lastAccessedComparestringNoUsed alongside the ‘lastAccessed’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3300.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
availability.availablestringNoSearch for users with availability.available properties that contain this value. Since: 3100.0.0 | Type | Description | --------- | --------- | | Yes | | | No | | | Disabled | 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. “created(desc)” Supported fields are: - created - lastAccessed (Since 3300.9.0) Since: 3100.0.0
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>user</li></ul>

blackboard_groups_get_learn_api_public_courses_by_courseid_users_by_userid

Get Membership 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 |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | 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>user</li></ul>

blackboard_groups_get_learn_api_public_users_by_userid_courses

Get User Memberships Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | 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.
rolestringNoSearch for memberships with a course role id that matches this value. Since: 3500.5.0
createdstringNoSearch for memberships with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3100.0.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3100.0.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedstringNoSearch for memberships with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.9.0
modifiedComparestringNoUsed alongside the ‘modified’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3800.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
dataSourceIdstringNoSearch for memberships with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3100.0.0
lastAccessedstringNoSearch for memberships with a last accessed date relative to this value. ‘lastAccessedCompare’ may also be sent to control search behavior. Since: 3300.9.0
lastAccessedComparestringNoUsed alongside the ‘lastAccessed’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3300.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
availability.availablestringNoSearch for users with availability.available properties that contain this value. Since: 3100.0.0 | Type | Description | --------- | --------- | | Yes | | | No | | | Disabled | 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. “created(desc)” Supported fields are: - created - lastAccessed (Since 3300.9.0) Since: 3100.0.0
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_groups_patch_learn_api_public_courses_by_courseid_groups_by_groupid

Update Group 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 |
groupIdstringYesThe group 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:breakfastClub |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoSettings controlling availability of the group to students.
descriptionstringNoThe description of the group. 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.
enrollmentobjectNoSettings controlling enrollment of the group to students.
externalIdstringNoAn externally-defined unique ID for the group. Defaults to a random UUID if not provided during create.
namestringNoThe title of the group.

blackboard_groups_patch_learn_api_public_courses_by_courseid_groups_sets_by_groupid

Update Group Set Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesThe group 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:breakfastClub |
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 group to students.
descriptionstringNoThe description of the group. 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.
enrollmentobjectNoSettings controlling enrollment of the group to students.
externalIdstringNoAn externally-defined unique ID for the group. Defaults to a random UUID if not provided during create.
namestringNoThe title of the group.

blackboard_groups_patch_learn_api_public_courses_by_courseid_messages_by_messageid

Update Message 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 |
messageIdstringYesMessage Id
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
isReadbooleanNoWhether or not the message has been read

blackboard_groups_patch_learn_api_public_courses_by_courseid_users_by_userid

Update Membership 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 |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoThe availability value
childCourseIdstringNoThe primary ID of the child, cross-listed course, in which the user is directly enrolled. </p> This field is read only in Learn versions 3000.11.0 through 3400.0.0. As of 3400.1.0, this field is mutable. </p> If this membership’s course is a parent course in a cross-listed set, the childCourseId can be updated to move the membership enrollment between child courses and the parent course in the set. Patching the childCourseId to “null” will move the membership to the parent course. Since: 3000.11.0
courseRoleIdstringNoThe user’s role in the course. These roles are also valid for an organization, although they are named differently in the UI. Custom course roles may also be referenced by their IDs. | Type | Description | --------- | --------- | | Instructor | Has access to all areas in the Control Panel. This role is generally given to those developing, teaching, or facilitating the class. Instructors may access a course that is unavailable to students. This role is customizable and may have different capabilities from what is documented here. | | BbFacilitator | The facilitator is an instructor like role. Facilitators are restricted versions of an instructor, in that they are able to deliver course instruction and administer all aspects of a pre-constructed course, but are not allowed to modify or alter the course. This role is customizable and may have different capabilities from what is documented here. | | TeachingAssistant | The teaching assistant role is that of a co-teacher. Teaching assistants are able to administer all areas of a course. Their only limitations are those imposed by the instructor or Blackboard administrator at your school. This role is customizable and may have different capabilities from what is documented here. | | CourseBuilder | Manages the course without having access to student grades. This role is customizable and may have different capabilities from what is documented here. | | Grader | Assists the instructor in the creation, management, delivery, and grading of items. This role is customizable and may have different capabilities from what is documented here. | | Student | | | Guest | Has no access to the Control Panel. Areas within the course are made available to guests, but typically they can only view course materials; they do not have access to tests or assessments, and do not have permission to post on discussion boards. This role’s behavior is immutable. |
dataSourceIdstringNoThe ID of the data source associated with this course. This may optionally be the data source’s externalId using the syntax “externalId:math101”.

blackboard_groups_post_learn_api_public_courses_by_courseid_groups

Create Group 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 group to students.
descriptionstringNoThe description of the group. 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.
enrollmentobjectNoSettings controlling enrollment of the group to students.
externalIdstringNoAn externally-defined unique ID for the group. Defaults to a random UUID if not provided during create.
namestringYesThe title of the group.

blackboard_groups_post_learn_api_public_courses_by_courseid_groups_sets

Create Group 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 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoSettings controlling availability of the group to students.
descriptionstringNoThe description of the group. 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.
enrollmentobjectNoSettings controlling enrollment of the group to students.
externalIdstringNoAn externally-defined unique ID for the group. Defaults to a random UUID if not provided during create.
namestringYesThe title of the group.

blackboard_groups_post_learn_api_public_courses_by_courseid_groups_sets_by_groupid_groups

Create Group Set Child Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesThe group 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:breakfastClub |
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 group to students.
descriptionstringNoThe description of the group. 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.
enrollmentobjectNoSettings controlling enrollment of the group to students.
externalIdstringNoAn externally-defined unique ID for the group. Defaults to a random UUID if not provided during create.
namestringYesThe title of the group.

blackboard_groups_post_learn_api_public_courses_by_courseid_messages

Create Message 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.
attachmentobjectNoThe attachment value
bccUsersstring[]NoThe bcc participants of the message
bodystringNoThe body text of the message. 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.
ccUsersstring[]NoThe cc participants of the message
idstringNoThe ID of the message
isExistingAttachmentbooleanNoWhether or not the attachment is the existing attachment for the message
isReadbooleanNoWhether or not the message has been read
isReplybooleanNoWhether or not this message is a reply to another message
subjectstringNoThe subject of the message.
toUsersstring[]NoThe to participants of the message

blackboard_groups_put_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_userid

Create Group Membership 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 |
groupIdstringYesThe group 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:breakfastClub |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_groups_put_learn_api_public_courses_by_courseid_users_by_userid

Create Membership 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 |
userIdstringYesThe user 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:jsmith | | userName | userName:jsmith | | uuid | uuid:915c7567d76d444abf1eed56aad3beb5 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
availabilityobjectNoThe availability value
childCourseIdstringNoThe primary ID of the child, cross-listed course, in which the user is directly enrolled. </p> This field is read only in Learn versions 3000.11.0 through 3400.0.0. As of 3400.1.0, this field is mutable. </p> If this membership’s course is a parent course in a cross-listed set, the childCourseId can be updated to move the membership enrollment between child courses and the parent course in the set. Patching the childCourseId to “null” will move the membership to the parent course. Since: 3000.11.0
courseRoleIdstringNoThe user’s role in the course. These roles are also valid for an organization, although they are named differently in the UI. Custom course roles may also be referenced by their IDs. | Type | Description | --------- | --------- | | Instructor | Has access to all areas in the Control Panel. This role is generally given to those developing, teaching, or facilitating the class. Instructors may access a course that is unavailable to students. This role is customizable and may have different capabilities from what is documented here. | | BbFacilitator | The facilitator is an instructor like role. Facilitators are restricted versions of an instructor, in that they are able to deliver course instruction and administer all aspects of a pre-constructed course, but are not allowed to modify or alter the course. This role is customizable and may have different capabilities from what is documented here. | | TeachingAssistant | The teaching assistant role is that of a co-teacher. Teaching assistants are able to administer all areas of a course. Their only limitations are those imposed by the instructor or Blackboard administrator at your school. This role is customizable and may have different capabilities from what is documented here. | | CourseBuilder | Manages the course without having access to student grades. This role is customizable and may have different capabilities from what is documented here. | | Grader | Assists the instructor in the creation, management, delivery, and grading of items. This role is customizable and may have different capabilities from what is documented here. | | Student | | | Guest | Has no access to the Control Panel. Areas within the course are made available to guests, but typically they can only view course materials; they do not have access to tests or assessments, and do not have permission to post on discussion boards. This role’s behavior is immutable. |
dataSourceIdstringNoThe ID of the data source associated with this course. This may optionally be the data source’s externalId using the syntax “externalId:math101”.