Grade a single assignment submission (admin/lecturer)

POST /api/v1/assignment/submission/{submission}/grade

Manually grade or re-grade a specific submission. Can override AI-generated scores.

Path parameters

  • submission string Required

    UUID of the submission to grade

Responses

  • 200 application/json

    Submission graded successfully

  • 400 application/json

    Default bad request error 400 response

    Hide response attributes Show response attributes object
    • message string Required

      Response message

    • error string Required
    • statusCode number Required
  • 403

    Forbidden - Admin or Lecturer role required

  • 404

    Submission not found

POST /api/v1/assignment/submission/{submission}/grade
curl \
 --request POST 'http://localhost:3500/api/v1/assignment/submission/submission-456/grade'
Response examples (200)
{
  "message": "Submission graded successfully",
  "submission": {
    "id": "submission-456",
    "score": 90,
    "status": "GRADED",
    "feedback": "Excellent implementation with efficient algorithms",
    "gradedAt": "2025-11-18T10:00:00Z",
    "gradedBy": "lecturer-123"
  }
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}