# Introduction

The Learning Assignment API provides the ability to create standard learning assignments in Cornerstone Learning. It enables you to build integrations where the goal is to assign training to your learners. Standard learning assignments process and assign training once. An ideal use case for this API is to assign training to users based on event triggers that were previously performed manually, or not performed at all due to technical restrictions.

The API has three endpoints:

  • Create a standard learning assignment
  • Get details of a standard assignment you created using this API
  • Search standard assignments created using this API or through the learning assignment tool in the UI

Here's an example scenario illustrating how you can use this API:

  1. A system event occurring outside Cornerstone prompts the need for training to be assigned to users.
  2. Your system POSTs a request to the Learning Assignment API with the User IDs, training, and learning assignment Name.
  3. The Learning Assignment API processes the request and assigns the training to the user(s). The users will see this training appear in their transcript in Cornerstone Learning in the registered status.
  4. Your system can check the status of the assignment using the GET endpoint.
  5. Users(s) complete the training.

To learn more about the user interface alternative to the Learning Assignment API, the Learning Assignment Tool, read through Cornerstone's Help articles. These in-depth articles outline the application logic which the Learning Assignment API follows as well.

# Throttling

The throttling limit for the Learning Assignment API is 20 requests per minute, 1200 per hour and 28,800 per day.

In addition to the normal request throttling, the Learning Assignment API also has throttling based on the number of users and training being assigned. There is a limit of 60,000 assignments to users per day (UTC). That means you could make one Learning Assignment with 60,000 users and assign these users 1 training. You can calculate the number of assignments by taking the number of training in the learning assignment and multiply it by the number of users in the assignment. Curriculum children are considered individual training in this calculation. If you are having issues with these limits please contact Global Product Support with a description of your specific use case.