POST Grade a course builder submission
Submit a grade and feedback for a course builder submission. Supports points awarded, grader feedback, and optional graded response data. Automatically updates submission status to completed and records grading timestamp. Validates that grader has appropriate permissions before accepting the grade.
Submit a grade and feedback for a course builder submission. Supports points awarded, grader feedback, and optional graded response data. Automatically updates submission status to completed and records grading timestamp. Validates that grader has appropriate permissions before accepting the grade.
Send API keys and access tokens as Authorization: Bearer .
In: header
Path Parameters
The UUID of the submission to grade
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/course-builder/submissions/{id}/grade" \ -H "Content-Type: application/json" \ -d '{ "points_awarded": 85, "grader_feedback": "Good work overall. Could improve on structure." }'{ "data": { "id": "{id}", "organization_id": "{organization_id}", "attempt_id": "{attempt_id}", "question_id": "{question_id}", "points_awarded": 85, "grader_feedback": "Good work overall. Could improve on structure.", "status": "completed", "graded_at": "2025-10-06T10:30:00Z" }, "meta": { "organizationId": "{organizationId}" }}{ "error": "Invalid request body", "details": [ { "path": [ "points_awarded" ], "message": "Required" } ]}{ "error": "string", "code": "string", "message": "string"}{ "error": "string", "code": "string", "message": "string"}{ "error": "Submission not found or does not belong to your organization"}{ "error": "string", "code": "string", "message": "string"}