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.

See Bulk API - API History.

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 API Explorer, go to Admin > Tools > Edge > API Explorer. API Explorer can also be accessed directly at the following URL: http://apiexplorer.csod.com

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 Access Edge Bulk API History 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 - Curriculum Transcripts

Grants ability to use the Bulk API to load curriculum 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 - Curriculum

Grants ability to use the Bulk API to load curriculum learning object and structure 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 - 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 - External Training Transcripts

Grants ability to use the Bulk API to load external training 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 - 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 Transcripts

Grants ability to use the Bulk API to load material 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 - 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 - Session Parts

Grants ability to use the Bulk API to load session parts 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 Mapping

Grants ability to use the Bulk API to load test mapping 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 Transcripts

Grants ability to use the Bulk API to load video 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 - 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