Change the publishing status of a learning item via API

Introduction

You can use Learn365 API endpoints to change the status of learning modules and quizzes from published to unpublished, or vice versa, therefore making the content available or unavailable to learners when they take a course. Alternatively, you can edit a learning item (a learning module or a quiz) directly from the Learn365 Admin Center by configuring its publishing settings.

This article describes how you can use Learn365 APIs to change the publishing status of learning modules and quizzes of a course.

 

 

Prerequisites 

To change the publishing status of learning modules and quizzes, you need to get the relevant learning item data, then run a request to update the data.

The update request requires you to enter some parameters, which can be obtained the following way:

1. Go to https:/api.365.systems/ and log in with the relevant API key. For more information about the authorization process, see this article.

2. In the list of Learn365 API sections, find the relevant section for the learning item for which you want to change the publishing status: LearningModules or Quizzes.

3. Find the relevant GET request, which you'll use to get the required parameters of the learning item in question:

• For learning modules, find the GET method /odata/v2/LearningModules with the Returns the list of Learning Modules description.
  
  
• For quizzes, find the GET method /odata/v2/Quizzes with the Returns the list of Quizzes description.

4. Expand the relevant GET request and select Try it out.

5. In the $expand field of the relevant GET method, enter the following value to include the relevant type of data in the response:

• For learning modules, enter Configuration, Publishing. The response will include the publishing settings of the learning modules of the tenant and data about the items inside the learning modules.
  
  
• For quizzes, enter Courses. The response will include a list of courses in which the quiz is used.

If you have the ID or title of a learning item, you can narrow the response to include data about the relevant item only. To do this, in the $filter field, enter Id eq item ID or Title eq 'item title', for example Id eq 90796418-a6e5-446c-96e5-00733621f771 or Title eq 'Phishing awareness guidelines', respectively.

6. Select Execute to run the request.

7. Go to the Response block to see the results:

• Number 2xx (for example, 200) under Code shows that the request worked correctly. You can Download the data from the response to your computer in .JSON format.
• In the Response body field, you can see data about the learning items across the whole tenant. Search for the relevant learning item using Ctrl+F.

Now we have the data required to update the relevant learning item.

 

Update the publishing status of a learning item

Learning module

 

1. Find the LearningModules section, expand it, find the PUT method /odata/v2/LearningModules({Id}) with the Updates Learning Module description, and select Try it out.

2. Complete the fields, paying close attention to the required parameters:

• key:Id, a required parameter. Enter the ID of the learning module for which you want to update the publishing settings.
  
  
• In the Edit Value field, enter the data of the learning module you obtained in the previous section. The following example shows only the expected format of the data. Remember to use your own data when entering the parameters. Pay close attention to the IsEnabled parameter because true makes the learning module published and false makes it unpublished. 

 

 

3. When ready, select Execute to run the request.

4. Go to the Responses block to check the results.

• Number 2xx (for example, 200) under Code shows that the request worked correctly. 
• You can check the results in the Learn365 Admin Center > Training Management > select the course that contains the relevant learning module > check the publishing status of the learning module in the Published column (Yes for published, No for unpublished).

   

  

 

Quiz

 

1. Find the Quizzes section, expand it, find the PUT method /odata/v2/Quizzes({Id}) with the Updates a Quiz description, and select Try it out.

2. Complete the fields, paying close attention to the required parameters:

• key:Id, a required parameter. Enter the ID of the quiz for which you want to update the publishing settings.
  

• In the Edit Value field, enter the data of the quiz obtained in the previous section. The following example shows only the expected format of the data. Remember to use your own data when entering the parameters. Pay close attention to the IsEnabled parameter because true makes the quiz published and false makes it unpublished. 

 

 

3. When ready, select Execute to run the request.

4. Go to the Responses block to check the results.

• Number 2xx (for example, 200) under Code shows that the request worked correctly. 
• You can check the results in the Learn365 Admin Center > Content > Quizzes > select the relevant quiz > check the publishing status of the quiz in the Published column (Yes for published, No for unpublished).