/blackboard-groups | Type: Application | PCID required: Yes
Tools
blackboard_groups_delete_learn_api_public_courses_by_courseid_groups_by_groupid
Delete Group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | The 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 | |
courseId | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
messageId | string | Yes | — | Message Id |
folderType | string | No | — | Specifies the folder type, The default type is inbox | Type | Description | --------- | --------- | | Inbox | | | Sent | | | Delete | | | Custom | | |
folderName | string | No | — | Specifies the folder name of the custom folder |
blackboard_groups_delete_learn_api_public_courses_by_courseid_users_by_userid
Delete Membership Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
name | string | No | — | The group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0 |
nameCompare | string | No | — | Used alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | | |
inGroupSet | boolean | No | — | Indicates whether only groups in a GroupSet (or groups NOT in a GroupSet) should be included Since: 3900.10.0 |
created | string | No | — | Search for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
createdCompare | string | No | — | Used alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
modified | string | No | — | Search for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
modifiedCompare | string | No | — | Used alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
sort | string | No | — | Properties 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 |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | The 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 | |
courseId | string | Yes | — | The 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 | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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 | |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
name | string | No | — | The group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0 |
nameCompare | string | No | — | Used alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | | |
created | string | No | — | Search for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
createdCompare | string | No | — | Used alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
modified | string | No | — | Search for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
modifiedCompare | string | No | — | Used alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
sort | string | No | — | Properties 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 |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | The 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 | |
name | string | No | — | The group ‘name’ value to use as search criteria. See also: nameCompare. Since: 3900.10.0 |
nameCompare | string | No | — | Used alongside the ‘name’ search parameter. Defaults to StartsWith if not specified. Since: 3900.10.0 | Type | Description | --------- | --------- | | equals | | | notEquals | | | contains | | | notContains | | | startsWith | | |
created | string | No | — | Search for groups with created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
createdCompare | string | No | — | Used alongside the ‘created’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
modified | string | No | — | Search for groups with modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.8.0 |
modifiedCompare | string | No | — | Used alongside the ‘modified’ search parameter. Defaults to greaterOrEqual if not specified. Since: 3800.8.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
sort | string | No | — | Properties 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 |
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
folderType | string | No | — | Specifies the folder type, The default type is inbox | Type | Description | --------- | --------- | | Inbox | | | Sent | | | Delete | | | Custom | | |
folderName | string | No | — | Specifies the folder name of the custom folder |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
sort | string | No | — | Properties 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 |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
messageId | string | Yes | — | Message Id |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
participationType | string | No | — | Search the participation type Since: 3800.20.0 |
sort | string | No | — | Properties 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 |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
role | string | No | — | Search for memberships with a course role id that matches this value. Since: 3500.5.0 |
created | string | No | — | Search for memberships with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3100.0.0 |
createdCompare | string | No | — | Used alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3100.0.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
modified | string | No | — | Search for memberships with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.9.0 |
modifiedCompare | string | No | — | Used alongside the ‘modified’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3800.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
dataSourceId | string | No | — | Search for memberships with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3100.0.0 |
lastAccessed | string | No | — | Search for memberships with a last accessed date relative to this value. ‘lastAccessedCompare’ may also be sent to control search behavior. Since: 3300.9.0 |
lastAccessedCompare | string | No | — | Used alongside the ‘lastAccessed’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3300.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
availability.available | string | No | — | Search for users with availability.available properties that contain this value. Since: 3100.0.0 | Type | Description | --------- | --------- | | Yes | | | No | | | Disabled | Since: 3100.0.0 | |
sort | string | No | — | Properties 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 |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | The 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 | |
offset | integer | No | — | The number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter. |
limit | integer | No | — | The maximum number of results to be returned. There may be less if the query returned less than the maximum. |
role | string | No | — | Search for memberships with a course role id that matches this value. Since: 3500.5.0 |
created | string | No | — | Search for memberships with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3100.0.0 |
createdCompare | string | No | — | Used alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3100.0.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
modified | string | No | — | Search for memberships with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3800.9.0 |
modifiedCompare | string | No | — | Used alongside the ‘modified’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3800.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
dataSourceId | string | No | — | Search for memberships with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3100.0.0 |
lastAccessed | string | No | — | Search for memberships with a last accessed date relative to this value. ‘lastAccessedCompare’ may also be sent to control search behavior. Since: 3300.9.0 |
lastAccessedCompare | string | No | — | Used alongside the ‘lastAccessed’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3300.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | | |
availability.available | string | No | — | Search for users with availability.available properties that contain this value. Since: 3100.0.0 | Type | Description | --------- | --------- | | Yes | | | No | | | Disabled | Since: 3100.0.0 | |
sort | string | No | — | Properties 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 |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
expand | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | Settings controlling availability of the group to students. |
description | string | No | — | The description of the group. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
enrollment | object | No | — | Settings controlling enrollment of the group to students. |
externalId | string | No | — | An externally-defined unique ID for the group. Defaults to a random UUID if not provided during create. |
name | string | No | — | The title of the group. |
blackboard_groups_patch_learn_api_public_courses_by_courseid_groups_sets_by_groupid
Update Group Set Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | The 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 | |
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | Settings controlling availability of the group to students. |
description | string | No | — | The description of the group. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
enrollment | object | No | — | Settings controlling enrollment of the group to students. |
externalId | string | No | — | An externally-defined unique ID for the group. Defaults to a random UUID if not provided during create. |
name | string | No | — | The title of the group. |
blackboard_groups_patch_learn_api_public_courses_by_courseid_messages_by_messageid
Update Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
messageId | string | Yes | — | Message Id |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
isRead | boolean | No | — | Whether or not the message has been read |
blackboard_groups_patch_learn_api_public_courses_by_courseid_users_by_userid
Update Membership Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | The availability value |
childCourseId | string | No | — | The 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 |
courseRoleId | string | No | — | The 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. | |
dataSourceId | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | Settings controlling availability of the group to students. |
description | string | No | — | The description of the group. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
enrollment | object | No | — | Settings controlling enrollment of the group to students. |
externalId | string | No | — | An externally-defined unique ID for the group. Defaults to a random UUID if not provided during create. |
name | string | Yes | — | The title of the group. |
blackboard_groups_post_learn_api_public_courses_by_courseid_groups_sets
Create Group Set Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | Settings controlling availability of the group to students. |
description | string | No | — | The description of the group. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
enrollment | object | No | — | Settings controlling enrollment of the group to students. |
externalId | string | No | — | An externally-defined unique ID for the group. Defaults to a random UUID if not provided during create. |
name | string | Yes | — | The title of the group. |
blackboard_groups_post_learn_api_public_courses_by_courseid_groups_sets_by_groupid_groups
Create Group Set Child Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | The 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 | |
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | Settings controlling availability of the group to students. |
description | string | No | — | The description of the group. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
enrollment | object | No | — | Settings controlling enrollment of the group to students. |
externalId | string | No | — | An externally-defined unique ID for the group. Defaults to a random UUID if not provided during create. |
name | string | Yes | — | The title of the group. |
blackboard_groups_post_learn_api_public_courses_by_courseid_messages
Create Message Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
attachment | object | No | — | The attachment value |
bccUsers | string[] | No | — | The bcc participants of the message |
body | string | No | — | The body text of the message. This field supports BbML; see <a target=’_blank’ href=‘https://docs.blackboard.com/learn/rest/advanced/bbml.html’>here</a> for more information. |
ccUsers | string[] | No | — | The cc participants of the message |
id | string | No | — | The ID of the message |
isExistingAttachment | boolean | No | — | Whether or not the attachment is the existing attachment for the message |
isRead | boolean | No | — | Whether or not the message has been read |
isReply | boolean | No | — | Whether or not this message is a reply to another message |
subject | string | No | — | The subject of the message. |
toUsers | string[] | No | — | The to participants of the message |
blackboard_groups_put_learn_api_public_courses_by_courseid_groups_by_groupid_users_by_userid
Create Group Membership Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
groupId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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 | |
fields | string | No | — | A 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
courseId | string | Yes | — | The 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 | |
userId | string | Yes | — | The 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 | |
fields | string | No | — | A comma-delimited list of fields to include in the response. If not specified, all fields will be returned. |
availability | object | No | — | The availability value |
childCourseId | string | No | — | The 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 |
courseRoleId | string | No | — | The 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. | |
dataSourceId | string | No | — | The ID of the data source associated with this course. This may optionally be the data source’s externalId using the syntax “externalId:math101”. |

