Content Management and ILT creation APIs

Skilljar has API updates that you might be able to leverage to improve your integration of adding courses and content into Skilljar.

Note: This article is focused on Developers and Integrations that are looking to build out API tooling that automatically adds content to Skilljar 

• Getting Started with the Skilljar API
• https://api.skilljar.com/docs/

Create or Update a Course and Lessons

Recommendation on how you might want to setup this flow:

1. Store a Skilljar API key to the integration config which can be created in the Skilljar Dashboard.
2. Create the Content Via Content APIs
   1. Create Skilljar Assets
      1. WebPackage
      2. Asset (used for Videos, PDFs, Iframe embeds)
3. Create Skilljar Courses
4. Creates Skilljar Lessons
   1. Associates relevant Assets to the lessons or lesson content items

Once this content Is created in Skilljar, an Admin can go review the content, settings, and Publish this content to the relevant training domains. 

 Full API Details for these instructions

1. Create Assets/Web-packages that will be used in the lessons in the course
   1. https://api.skilljar.com/docs/#assets-create  
   2. https://api.skilljar.com/docs/#web-packages-create    
   3. Store the relevant Asset/Web-package IDs for Lesson Creation API calls
2. Create the Course Object
   1. https://api.skilljar.com/docs/#courses-create
   2. Store the relevant course ID for Lesson Creation API calls
3. Create Lessons in the course
   1. https://api.skilljar.com/docs/#lessons-create
      1. For SCORM providers: Use the WebPackage ID in the relevant field (and make the lesson type=WEBPACKAGE) to create SCORM lessons in the course
      2. For VIDEO providers, You can either use Type=VIDEO and link the Asset ID or can create a MODULAR lesson which allows adding a Video and HTML to the same lesson object
      3. If this is a MODULAR lesson (multiple assets in one lesson object) then each lesson content Item can be added in via the Lesson Content Item Endpoints with lesson ID as the required input
         1. https://api.skilljar.com/docs/#lesson-content-item-create
      4. Use the relevant IDs from Asset creation above to assign Assets to the relevant lessons upon creation

Note: Deletion of Courses/Lessons/Assets must happen within the Dashboard

Note: The "Try it out" feature on api.skilljar.com/docs is very useful to test out your API flows, but some URLs provided in the JSON response may not format correctly in the main widget (eg. Asset download URLs). These are formatted correctly in the "RAW" response if you are looking to accurately represent what your systems will be able to access when using the Skilljar API. 

Note on Webpackage Replacement:

Create Live Training Events

Recommendation on how you might want to setup this flow:

1. Store a Skilljar API key to the integration config which can be created in the Skilljar Dashboard.
   1. Look up the course and Lesson to have the relevant IDs when creating events
   2. Look up the Instructor Options if creating an Event with an Integration
2. List instructors - can be filtered by email or integration type
3. Create the ILT events
   1. uses stored API key to call relevant APIs to create ILT sessions or MSE objects
   2. For MSEs, the MSE should be created prior to the individual sessions
   3. For Sessions, only the ILT lesson is needed

Full API Details for these instructions

1. Get the Lesson ID for the course that these events are being added to
   1. Getting the Lesson ID may require having the course id
      1. https://api.skilljar.com/docs/#courses-list
   2. Lesson ID
      1. https://api.skilljar.com/docs/#lessons-list
   3. Store the lesson ID for later Session Creation
2. List ILT instructors (if using an integration type)
   1. https://api.skilljar.com/docs/#lessons-list
   2. Filter by email or Event type
   3. Store the Instructor email/type
3. (Optional if using MSE) Create MSE object
   1. https://api.skilljar.com/docs/#ilt-multi-session-events-create
   2. Store the MSE ID if needed
4. Create Session
   1. https://api.skilljar.com/docs/#ilt-sessions-create 
   2. Lesson ID is required for Single events, MSE ID is required if hte event is part of a Multi Session event