Learner Service

API V2 reference

This page applies to SCORM Cloud API V2. If you're looking for our V1 api reference see here

deleteAllLearnerData

POST /learner/{learnerId}/delete-information

Summary

Deletes all of the information associated with a learner in an application, by learner id. This is meant for use with complying with GDPR requests from learners.

Parameters

Consumes: application/json

Type Name Required Schema
Path learnerId true String
Query userEmail true String

Responses:

Produces: application/json

HTTP Code Description Schema
204 Operation started to destroy learner’s data
403 The initiating email address does not have sufficient privilege in this application to perform this delete operation. MessageSchema
404 A learner with the learner id could not be found in the application MessageSchema

Authentication:

Type Name Scopes
basic APP_NORMAL
oauth2 OAUTH admin




deleteLearnerTags

DELETE /learner/{learnerId}/tags

Summary

Delete the tags for this learner

Parameters

Consumes: application/json

Type Name Required Schema
Path learnerId true String
Body tags true TagListSchema

Responses:

Produces: application/json

HTTP Code Description Schema
204 Set tags successfully
400 Bad request MessageSchema
404 learnerId was not found MessageSchema

Authentication:

Type Name Scopes
basic APP_NORMAL
oauth2 OAUTH write:learner




getLearnerTags

GET /learner/{learnerId}/tags

Summary

Get the tags for this learner

Parameters

Consumes: application/json

Type Name Required Schema
Path learnerId true String

Responses:

Produces: application/json

HTTP Code Description Schema
200 List of tags for this learner TagListSchema
400 Bad request MessageSchema
404 learnerId was not found MessageSchema

Authentication:

Type Name Scopes
basic APP_NORMAL
oauth2 OAUTH read:learner




putLearnerTags

PUT /learner/{learnerId}/tags

Summary

Set the tags for this learner

Parameters

Consumes: application/json

Type Name Required Schema
Path learnerId true String
Body tags true TagListSchema

Responses:

Produces: application/json

HTTP Code Description Schema
204 Set tags successfully
400 Bad request MessageSchema
404 learnerId was not found MessageSchema

Authentication:

Type Name Scopes
basic APP_NORMAL
oauth2 OAUTH write:learner




putLearnerTagsBatch

PUT /learner/tags

Summary

Sets all of the provided tags on all of the provided learners

Parameters

Consumes: application/json

Type Name Required Schema
Body batch true BatchTagsSchema

Responses:

Produces: application/json

HTTP Code Description Schema
204 Set tags successfully
400 Bad request MessageSchema
404 learnerId was not found MessageSchema

Authentication:

Type Name Scopes
basic APP_NORMAL
oauth2 OAUTH write:learner