Exam Feedback and Weakness Reports
Exam Feedback Integration Guide
Submit exam responses to receive AI feedback and weakness reports
Getting Started
Once a learner finishes an exam and it has been scored, send their responses to receive per-question AI feedback and a weakness report for that attempt.
Overview
Step 1: Submit responsesWriting as JSON, Speaking with audio files
Step 2: Writing feedbackAudio is transcribed first. Takes a few minutes
Step 3: Retrieve resultsUse the job_id from the submission response
Sending One Attempt
A single learner's attempt is submitted by section.
| Step | API | Content |
|---|---|---|
| 1 | POST /api/v1/courses/exam-gradings/writing | Writing, 12 questions with their responses |
| 2 | POST /api/v1/courses/exam-gradings/speaking | Speaking, 11 questions with their responses |
| 3 | GET /api/v1/courses/exam-gradings/{job_id} | Retrieve the result for each question |
One job is created per item in items.