Introduction
Understand the data model, base URL, and conventions before your first call.
Authentication
Create API keys, configure scopes, and understand team scope boundaries.
Import & Correct
Step-by-step guide from blank exam to graded results.
API Reference
Full endpoint reference for exams, copies, corrections, and more.
How It Works
1
Create an exam
Use
POST /api/v1/exams to create an exam in your team workspace, then set its title, language, and grading settings via PATCH.2
Upload student copies
Register each file with
POST /api/v1/uploads to get a presigned URL, then push the file directly to object storage — bypassing rate limits entirely.3
Attach copies and launch correction
Link uploaded files to student records with
POST /exams/{examId}/copies, then fire POST /exams/{examId}/corrections with an idempotency key to start AI grading.4
Retrieve grades
Poll
GET /exams/{examId}/corrections every 15–30 seconds. Filter on status === "success" to get final scores, comments, and feedback per student.The grading rubric (barème) must be validated in the Examino web application before you can launch a correction via API. The API handles everything else.