Manage enrollments via the Blackboard Learn REST API

Steps

1. Register your REST integration in the Blackboard developer portal at developer.blackboard.com to obtain a client application key and secret; then install the integration on the target Learn instance from the administrator panel.
2. Obtain an OAuth 2.0 access token by POSTing to /learn/api/public/v1/oauth2/token with Content-Type: application/x-www-form-urlencoded, a Basic Authorization header containing your base64-encoded key:secret, and body grant_type=client_credentials.
3. Pass the returned access_token as a Bearer token in subsequent calls; tokens are valid for one hour — implement token refresh logic before expiry rather than waiting for a 401 response.
4. Create a course enrollment by POSTing to /learn/api/public/v1/courses/:courseId/users/:userId with body {courseRoleId: 'Student', availability: {available: 'Yes'}}; the courseId and userId can be Blackboard internal IDs or prefixed SIS IDs (e.g., externalId:SIS_CODE).
5. List enrollments for a course via GET /learn/api/public/v1/courses/:courseId/users; use offset and limit query parameters to paginate and check the paging.nextPage field in the response envelope for the next page URL.
6. Delete an enrollment via DELETE /learn/api/public/v1/courses/:courseId/users/:userId; a 204 response indicates success.