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

Tools

ToolDescription
blackboard_users_delete_learn_api_public_datasources_by_datasourceidDelete Data Source
blackboard_users_delete_learn_api_public_users_by_useridDelete User
blackboard_users_delete_learn_api_public_users_by_userid_observers_by_observeridDelete Observer
blackboard_users_get_learn_api_public_courserolesGet Course Roles
blackboard_users_get_learn_api_public_courseroles_by_roleidGet Course Role
blackboard_users_get_learn_api_public_datasourcesGet Data Sources
blackboard_users_get_learn_api_public_datasources_by_datasourceidGet Data Source
blackboard_users_get_learn_api_public_institutionrolesGet Institution Roles
blackboard_users_get_learn_api_public_institutionroles_by_roleidGet Institution Role
blackboard_users_get_learn_api_public_oauth2_authorizationcodeAuthorization Code
blackboard_users_get_learn_api_public_oauth2_tokeninfoGet Token Info
blackboard_users_get_learn_api_public_sessionsGet Active Sessions
blackboard_users_get_learn_api_public_systemrolesGet System Roles
blackboard_users_get_learn_api_public_systemroles_by_roleidGet System Role
blackboard_users_get_learn_api_public_usersGet Users
blackboard_users_get_learn_api_public_users_by_useridGet User
blackboard_users_get_learn_api_public_users_by_userid_avatarGet User Avatar
blackboard_users_get_learn_api_public_users_by_userid_observeesGet Observees
blackboard_users_get_learn_api_public_users_by_userid_observersGet Observers
blackboard_users_get_learn_api_public_users_by_userid_sessionsGet Current Active User By Id
blackboard_users_patch_learn_api_public_datasources_by_datasourceidUpdate Data Source
blackboard_users_patch_learn_api_public_users_by_useridUpdate User
blackboard_users_post_learn_api_public_datasourcesCreate Data Source
blackboard_users_post_learn_api_public_oauth2_tokenRequest Token
blackboard_users_post_learn_api_public_usersCreate User
blackboard_users_put_learn_api_public_users_by_userid_observers_by_observeridCreate Observer

blackboard_users_delete_learn_api_public_datasources_by_datasourceid

Delete Data Source Parameters:
ParameterTypeRequiredDefaultDescription
dataSourceIdstringYesThe data source ID. This may be the primary ID, or the secondary ID prefixed with the ID type. | ID type | Example | |------------|--------------------| | primary | _123_1 | | externalId | externalId:math101 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_delete_learn_api_public_users_by_userid

Delete User 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 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_delete_learn_api_public_users_by_userid_observers_by_observerid

Delete Observer 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 |
observerIdstringYesThe 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 | Since: 3500.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_courseroles

Get Course Roles Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
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.family(desc),created” Since: 3100.0.0
custombooleanNoSearch course roles by whether they are a custom or system generated course role. Since: 3300.5.0
roleIdstringNoSearch course roles using their roleId’s. Any course role with a roleId that contains the given string will be returned. The search is case insensitive. Since: 3300.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_courseroles_by_roleid

Get Course Role Parameters:
ParameterTypeRequiredDefaultDescription
roleIdstringYesThe course role ID. This may be the primary ID, or the roleId. The suffix “:custom” will be appended to the roleId of a custom course role if that roleId conflicts with the roleId of a system generated course role. For example, if a custom role roleId is specified as “Student” then the roleId will actually be “Student:custom” since there is already a system generated course role with the roleId of “Student”. | ID type | Examples | |------------|------------------------------------------------------------| | primary | _123_1 | | roleId | roleId:Student, roleId:MyCustomRole, roleId:Student:custom | Since: 3300.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_datasources

Get Data Sources Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
externalIdstringNoThe ‘batchUid’ value to use as search criteria. Currently only supports ‘contains’ searches.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_datasources_by_datasourceid

Get Data Source Parameters:
ParameterTypeRequiredDefaultDescription
dataSourceIdstringYesThe data source ID. This may be the primary ID, or the secondary ID prefixed with the ID type. | ID type | Example | |------------|--------------------| | primary | _123_1 | | externalId | externalId:math101 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_institutionroles

Get Institution Roles Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
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. “roleId(desc)” Supported fields are: - roleId - custom Since: 3300.4.0
roleIdstringNoSearch for institution roles with roleId properties that contain this value. Since: 3300.4.0
custombooleanNoSearch for institution roles by custom flag. A value of ‘true’ indicates that search results should be limited to only custom roles. A value of ‘false’ indicates results should be limited to built-in roles. Not setting this field indicates that all institution roles should be returned. Since: 3300.4.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_institutionroles_by_roleid

Get Institution Role Parameters:
ParameterTypeRequiredDefaultDescription
roleIdstringYesThe institution role ID. This may be the primary ID, or any of the secondary IDs prefixed with the ID type. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | roleId | roleId:STUDENT | Since: 3300.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_oauth2_authorizationcode

Authorization Code Parameters:
ParameterTypeRequiredDefaultDescription
redirect_uristringNothe redirectUri to send the end user to once an authorization code response is made in Oauth2 Authorization Code Workflow
response_typestringNoRequired. The response_type expected which must to be set to “code”
client_idstringNoRequired. The client identifier for the registered application.
scopestringNothe space delimited scope(s) being requested for this authorization. Example value: “read write offline”
statestringNoOpaque value used by client to maintain state between request and callback. Used to prevent cross-site request forgery.
code_challengestringNoA code challenge to verify credentials along with the granted authorization code. It is used with the PKCE standard. Since: 3700.4.0
code_challenge_methodstringNoThis is the method used to verify the code challenge using the PKCE standard. Blackboard only supports s256 as the code challenge method. Since: 3700.4.0
one_time_session_tokenstringNoToken used to retrieve the session that generated this Oauth2 Code request. Used when session cookies are not sent due to privacy settings of the browser. Since: 3900.13.0

blackboard_users_get_learn_api_public_oauth2_tokeninfo

Get Token Info Parameters:
ParameterTypeRequiredDefaultDescription
access_tokenstringYesThe application key and secret, encoded using RFC 2617 Basic authentication.

blackboard_users_get_learn_api_public_sessions

Get Active Sessions Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
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_users_get_learn_api_public_systemroles

Get System Roles Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
roleIdstringNoSearch for system roles with roleId Since: 3300.5.0
custombooleanNoSearch for system roles by custom flag. A value of ‘true’ indicates that search results should be limited to only custom roles. A value of ‘false’ indicates results should be limited to built-in roles. Not setting this field indicates that all system roles should be returned. Since: 3300.5.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. “roleId(desc)” Supported fields are: <ul - roleId - custom Since: 3300.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_systemroles_by_roleid

Get System Role Parameters:
ParameterTypeRequiredDefaultDescription
roleIdstringYesThe System Role ID. This may be the primary ID, or the secondary roleId type. The suffix “:custom” will be appended to the roleId of a custom system role if that roleId conflicts with the roleId of a system generated role. For example, if a custom role roleId is specified as “Guest” then the roleId will actually be “Guest:custom” since there is already a system generated role with the roleId of “Guest”. | ID type | Example | |------------|---------------------------------------| | primary | _123_1 | | roleId | roleId:column1 | Since: 3300.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_users

Get Users Parameters:
ParameterTypeRequiredDefaultDescription
offsetintegerNoThe number of rows to skip before beginning to return rows. An offset of 0 is the same as omitting the offset parameter.
limitintegerNoThe maximum number of results to be returned. There may be less if the query returned less than the maximum.
userNamestringNoSearch for users with userName properties that contain this value. Since: 3000.11.0
externalIdstringNoSearch for users with externalId properties that contain this value. Since: 3000.11.0
createdstringNoSearch for users with a created date relative to this value. ‘createdCompare’ may also be sent to control search behavior. Since: 3000.11.0
modifiedstringNoSearch for users with a modified date relative to this value. ‘modifiedCompare’ may also be sent to control search behavior. Since: 3700.1.0
lastLoginstringNoSearch for users with a last login date relative to this value. ‘lastLoginCompare’ may also be sent to control search behavior. A user who has never logged in would have a null last login date. This is not considered to be greater than, less than, or equal to a valid date. Such users will be filtered out any time this filter is used. Since: 3900.9.0
createdComparestringNoUsed alongside the ‘created’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3000.11.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
modifiedComparestringNoUsed alongside the ‘modifiedDate’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
lastLoginComparestringNoUsed alongside the ‘lastLoginDate’ search parameter. Supported values: - lessThan - greaterOrEqual Defaults to greaterOrEqual if not specified. Since: 3900.9.0 | Type | Description | --------- | --------- | | lessThan | | | greaterOrEqual | |
dataSourceIdstringNoSearch for users with this dataSourceId. This may optionally be the data source’s externalId using the syntax “externalId:math101”. Since: 3000.11.0
name.familystringNoSearch for users with name.family properties that contain this value. Since: 3000.11.0
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. “name.family(desc),created” Supported fields are: - userName - name.family - externalId - dataSourceId - created Since: 3100.0.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_get_learn_api_public_users_by_userid

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

blackboard_users_get_learn_api_public_users_by_userid_avatar

Get User Avatar 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 |

blackboard_users_get_learn_api_public_users_by_userid_observees

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

blackboard_users_get_learn_api_public_users_by_userid_observers

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

blackboard_users_get_learn_api_public_users_by_userid_sessions

Get Current Active User By Id 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.
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.

blackboard_users_patch_learn_api_public_datasources_by_datasourceid

Update Data Source Parameters:
ParameterTypeRequiredDefaultDescription
dataSourceIdstringYesThe data source ID. This may be the primary ID, or the secondary ID prefixed with the ID type. | ID type | Example | |------------|--------------------| | primary | _123_1 | | externalId | externalId:math101 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
descriptionstringNoThe description of the data source.
externalIdstringNoAn externally-defined unique ID for the data source. Formerly known as ‘batchUid’.

blackboard_users_patch_learn_api_public_users_by_userid

Update User 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 |
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
addressobjectNoThe user’s mailing address.
availabilityobjectNoSettings controlling availability of the user account.
avatarobjectNoThe user’s avatar metadata Since: 3800.13.0
birthDatestringNoThe birth date of this user. Only the date portion of this value has significance, since a person’s birthdate represents a full day and not a moment in time. Take care to ignore the zeroed time portion when deserializing this value to ensure it’s not converted to the previous calendar day if your local time zone has a negative UTC offset.
contactobjectNoThe user’s contact information.
dataSourceIdstringNoThe ID of the data source associated with this user. This may optionally be the data source’s externalId using the syntax “externalId:math101”.
educationLevelstringNoThe education level of this user. | Type | Description | --------- | --------- | | K8 | Kindergarten through 8th grade | | HighSchool | Grades 9 through 12. | | Freshman | College or university freshman. | | Sophomore | College or university sophomore. | | Junior | College or university junior. | | Senior | College or university senior. | | GraduateSchool | Graduate school student. | | PostGraduateSchool | Post-graduate school student. | | Unknown | Education Level is not known, or not specified. |
externalIdstringNoAn optional externally-defined unique ID for the user. Defaults to the userName. Formerly known as ‘batchUid’.
genderstringNoThe gender of this user. | Type | Description | --------- | --------- | | Female | Female | | Male | Male | | Unknown | Gender is not known, or not specified. |
institutionRoleIdsstring[]NoThe primary and secondary institution roles assigned to this user. The primary institution role is the first item in the list, followed by all secondary institution roles sorted alphabetically. Since: 3300.3.0
jobobjectNoThe user’s job information.
localeobjectNoThe user’s localization settings.
nameobjectNoProperties used to build the user’s display name.
passwordstringNoThe user’s login password.
studentIdstringNoThe user’s student ID name or number as defined by the school or institution.
systemRoleIdsstring[]NoThe system roles (the administrative user roles in the UI) for this user. The first role in this list is the user’s primary system role, while the remaining are secondary system roles.
userNamestringNoThe userName property, shown in the UI.

blackboard_users_post_learn_api_public_datasources

Create Data Source Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
descriptionstringNoThe description of the data source.
externalIdstringYesAn externally-defined unique ID for the data source. Formerly known as ‘batchUid’.

blackboard_users_post_learn_api_public_oauth2_token

Request Token Parameters:
ParameterTypeRequiredDefaultDescription
grant_typestringNoThe Grant Type. Acceptable values include: ‘client_credentials’, ‘authorization_code’ (since 3200.7.0), or ‘refresh_token’ (since 3200.7.0).
codestringNoThe authorization code granted by an end user for use by an application in Oauth2 Authorization Code Workflow
redirect_uristringNoThe redirectUri to send the end user to once an access token response is made in Oauth2 Authorization Code Workflow Since: 3200.7.0
refresh_tokenstringNoThe refresh token granted for use by an application in Oauth2 Refresh Token Workflow Since: 3200.7.0
code_verifierstringNoThe code_verifier to be passed along with authorization code if PKCE standard was used to grant the authorization code. Since: 3700.4.0

blackboard_users_post_learn_api_public_users

Create User Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.
addressobjectNoThe user’s mailing address.
availabilityobjectNoSettings controlling availability of the user account.
avatarobjectNoThe user’s avatar metadata Since: 3800.13.0
birthDatestringNoThe birth date of this user. Only the date portion of this value has significance, since a person’s birthdate represents a full day and not a moment in time. Take care to ignore the zeroed time portion when deserializing this value to ensure it’s not converted to the previous calendar day if your local time zone has a negative UTC offset.
contactobjectNoThe user’s contact information.
dataSourceIdstringNoThe ID of the data source associated with this user. This may optionally be the data source’s externalId using the syntax “externalId:math101”.
educationLevelstringNoThe education level of this user. | Type | Description | --------- | --------- | | K8 | Kindergarten through 8th grade | | HighSchool | Grades 9 through 12. | | Freshman | College or university freshman. | | Sophomore | College or university sophomore. | | Junior | College or university junior. | | Senior | College or university senior. | | GraduateSchool | Graduate school student. | | PostGraduateSchool | Post-graduate school student. | | Unknown | Education Level is not known, or not specified. |
externalIdstringNoAn optional externally-defined unique ID for the user. Defaults to the userName. Formerly known as ‘batchUid’.
genderstringNoThe gender of this user. | Type | Description | --------- | --------- | | Female | Female | | Male | Male | | Unknown | Gender is not known, or not specified. |
institutionRoleIdsstring[]NoThe primary and secondary institution roles assigned to this user. The primary institution role is the first item in the list, followed by all secondary institution roles sorted alphabetically. Since: 3300.3.0
jobobjectNoThe user’s job information.
localeobjectNoThe user’s localization settings.
nameobjectYesProperties used to build the user’s display name.
passwordstringYesThe user’s login password.
studentIdstringNoThe user’s student ID name or number as defined by the school or institution.
systemRoleIdsstring[]NoThe system roles (the administrative user roles in the UI) for this user. The first role in this list is the user’s primary system role, while the remaining are secondary system roles.
userNamestringYesThe userName property, shown in the UI.

blackboard_users_put_learn_api_public_users_by_userid_observers_by_observerid

Create Observer 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 |
observerIdstringYesThe 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 | Since: 3500.5.0
fieldsstringNoA comma-delimited list of fields to include in the response. If not specified, all fields will be returned.