Built LMS Help Center
API Reference and PlaygroundCourse BuilderGenerated Courses

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.

POST
/course-builder/submissions/{id}/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.

Authorization

AuthorizationBearer <token>

Send API keys and access tokens as Authorization: Bearer .

In: header

Path Parameters

id*string

The UUID of the submission to grade

Formatuuid

Request 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}"  }}