Skip to main content
Answer

API endpoint for sending an external assessment's score and to mark a course as complete

  • January 12, 2023
  • 3 replies
  • 175 views
B
Novice II

So I’ve been searching for an endpoint that would let me mark a course as complete and import a score. I am already connected to Docebo through a data ingress API and I have the course ID, student ID, and user name. I can’t find anything on the API endpoint menu (though I am super new at this and probably looking in the wrong place). Any help would be great!

Best answer by Annarose.Peterson

@bhorishny , I believe you can do this with the endpoint PUT /learn/v1/enrollments

If I am not mistaken the completed status is 2?  But you can also add a score as well. 

I personally haven’t tested this, but it looks like it will deliver what you need. 

 

To see more on that endpoint if you go to the API browser page (https://<yoursubdomain.docebosaas.com>/api-browser/)

that endpoint can be found under the “Enrollments” section.

 

3 replies

Annarose.Peterson
Hero III
Forum|alt.badge.img+7

@bhorishny , I believe you can do this with the endpoint PUT /learn/v1/enrollments

If I am not mistaken the completed status is 2?  But you can also add a score as well. 

I personally haven’t tested this, but it looks like it will deliver what you need. 

 

To see more on that endpoint if you go to the API browser page (https://<yoursubdomain.docebosaas.com>/api-browser/)

that endpoint can be found under the “Enrollments” section.

 

Annarose Peterson (She/Her)
Bfarkas
Bfarkas
Hero III
Forum|alt.badge.img+6
  • Bfarkas
  • Hero III
  • January 12, 2023

@bhorishny , I believe you can do this with the endpoint PUT /learn/v1/enrollments

If I am not mistaken the completed status is 2?  But you can also add a score as well. 

I personally haven’t tested this, but it looks like it will deliver what you need. 

 

To see more on that endpoint if you go to the API browser page (https://<yoursubdomain.docebosaas.com>/api-browser/)

that endpoint can be found under the “Enrollments” section.

 

Concurred!

Annarose.Peterson
B
Novice II
  • bhorishny
  • Author
  • Novice II
  • January 13, 2023

@bhorishny , I believe you can do this with the endpoint PUT /learn/v1/enrollments

If I am not mistaken the completed status is 2?  But you can also add a score as well. 

I personally haven’t tested this, but it looks like it will deliver what you need. 

 

To see more on that endpoint if you go to the API browser page (https://<yoursubdomain.docebosaas.com>/api-browser/)

that endpoint can be found under the “Enrollments” section.

 

 

Thanks so much for this! One more question, we decided to use the API for a single enrollment change since each PUT request is for only one learner, but some of the fields we have no idea what they are for. We also were wondering if you know if all the fields are required to be in the request. We deleted some and got back some errors and couldn't get it to work. This is what we fed in, and the error we received:

 {
"date_inscr": "2023-01-13T18:57:24.344Z",
"date_last_access": "2023-01-13T18:57:24.344Z",
"date_complete": "2023-01-13T18:57:24.344Z",
"imported_from_connection": "Scorpion",
"status": 2,
"score_given": 100
}

Status code 400

Headers Array

Cookie headers Array Empty

DataCollection

name Bad Request

messageArray

code1006

status400

The score and dates we are pulling from the assessment platform, and we are connected with OAUTH/JWT.

Terms & ConditionsCookie settingsAccessibility statement