Bulk API
The Bulk API is available for user, organizational unit (OU), and learning loads. Bulk APIs provide organizations the ability to leverage a highly scalable and resilient framework to create and update data in Cornerstone via APIs.
- It is optimized for loading large data sets in an asynchronous, queued model. It is ideal for bulk load use cases where there is a need to create or update data into your Cornerstone portal using APIs. For example, you can use Bulk APIs to keep employee and OU data in sync from your HRIS into Cornerstone.
- It supports the OAuth 2.0 authentication framework.
- It supports the portal configurations including custom fields, custom employee relationships, and availability settings for custom fields.
Use the API to retrieve the status of your loads as well as obtain a full report of the load performed including errors and warnings. Additionally, all the loads performed using the Bulk API are visible in the Bulk API History page in Edge. The Bulk API History page is only visible to users who have the new Access Edge Bulk API History permission. Additional load-type specific permissions control the downloading of reports from the history page.
How Does this Enhancement Benefit My Organization?
This API enables organizations to keep their employee, organizational unit (OU), and learning information in Cornerstone up-to-date by loading data in bulk with a modern, scalable REST API.
API Explorer
API Explorer contains the most up-to-date documentation for all REST APIs. API Explorer enables developers and partners to easily browse all available REST APIs. Developers can learn about supported features, methods, and metadata. Developers can also download guidelines and access links to sample code.
To access the Developer Portal, go to https://csod.dev
. Developer Portal can also be accessed directly at the following URL:Considerations
- Organizations using Cornerstone HR cannot use the Bulk API to load employee data since effective dating is not yet supported by the Bulk API.
- SPII fields and secure custom fields are not supported by the Bulk API.
- There are new OAuth 2.0 scopes for Bulk API endpoints which is visible while registering a new OAuth 2.0 application or modifying an existing OAuth 2.0 application. Organizations with existing OAuth 2.0 applications must explicitly select the Bulk API scopes before utilizing the Bulk API endpoints.
Implementation
Organizations can self-activate the Bulk API for users, OUs, and learning loads via the Edge Marketplace in Pilot and Stage environments.
Organizations wanting to use the Bulk API in Production must submit a purchase inquiry via the Edge Marketplace. See Edge API - Purchase Inquiry.
The
permission is assigned the System Administrator role by default. The remaining permissions are enabled upon activation. Additional documentation is available in the API Explorer.Permissions
The following permissions apply to this functionality:
PERMISSION NAME | PERMISSION DESCRIPTION | CATEGORY |
Access Bulk API - LMS - Events |
Grants ability to use the Bulk API to load event learning object data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - ILT Transcripts |
Grants ability to use the Bulk API to load instructor-led training (ILT) transcript data, session transcript custom fields data, and event transcript custom fields data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Material |
Grants ability to use the Bulk API to load material learning object data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Online Course |
Grants ability to use the Bulk API to load online course learning object data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Online Transcripts |
Grants ability to use the Bulk API to load online transcripts data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Sessions |
Grants ability to use the Bulk API to load event session data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Test Transcripts |
Grants ability to use the Bulk API to load test transcript data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Test |
Grants ability to use the Bulk API to load test learning object data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Bulk API - LMS - Video |
Grants ability to use the Bulk API to load video learning object data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge Import |
Access Edge Bulk API History | Grants access to the Bulk API History page, which displays all the loads that have been performed using the Bulk API. Administrators can select a load to view additional details of the load, including the results. This permission cannot be constrained. This is an administrator permission. | Edge |
Access Edge Bulk API |
Grants ability to access and utilize the Bulk API. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Cost Center OU |
Grants ability to use the Bulk API to load cost center organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Custom OU |
Grants ability to use the Bulk API to load custom organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Division OU |
Grants ability to use the Bulk API to load division organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Employee |
Grants ability to use the Bulk API to load employee data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Grade OU |
Grants ability to use the Bulk API to load grade organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Legal Entity OU |
Grants ability to use the Bulk API to load legal entity organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Location OU |
Grants ability to use the Bulk API to load location organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Bulk API - Position OU |
Grants ability to use the Bulk API to load position organizational unit (OU) data. This permission cannot be constrained. This is an administrator permission. This permission is only available when the Bulk API is enabled via Edge Marketplace. |
Edge |
Security Roles
The Edge Bulk API History permission is automatically granted to the default System Administrator role. Administrators must grant this permission with the appropriate constraints to other roles, if necessary.
The remaining Bulk API permissions are disabled until the Bulk API is enabled through Edge Marketplace, at which time they are granted to the default System Administrator role.
Supported Learning Load Types
The Bulk API supports the following load types:
- Online course
- Online Course Metadata
- Online Course Transcript
- Online Course Transcript custom fields
- ILT
- Events
- Sessions
- Session Parts
- Events Transcript custom fields
- Sessions Transcript
- Sessions Transcript custom fields
- Material
- Material
- Material Transcript
- Material Transcript custom fields
- Video
- Video
- Video Transcript
- Video Transcript custom fields
- Test
- Test
- Test Mapping
- Test Transcript
- Test Transcript custom fields
- Curriculum
- Curriculum
- Curriculum Structure
- Curriculum Transcript
- Curriculum Transcript custom fields
- External Training
- External Training Transcript