Skip to content

Submission Returned

The submission.returned event is triggered when a teacher returns a submission to the student for revision. In addition to all submission.submitted properties, the payload may include the current rating.

PropertyTypeDescription
rateobjectThe rating given by the teacher (score, comment); absent if not rated

All timestamps are in ISO 8601 format and include a timezone offset (e.g. +08:00). Properties with empty values are omitted from the payload.

{
"type": "submission.returned",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"state": "returned",
"title": "My Week 1 Homework",
"content": "Here is my answer to the exercises...",
"submitted_at": "2024-03-22T10:30:00+08:00",
"created_at": "2024-03-22T10:29:00+08:00",
"updated_at": "2024-03-23T08:00:00+08:00",
"assignment": {
"id": "660e8400-e29b-41d4-a716-446655440111",
"name": "Week 1 Homework",
"course_id": "770e8400-e29b-41d4-a716-446655440222"
},
"student": {
"id": "880e8400-e29b-41d4-a716-446655440333",
"name": "Test Student",
"email": "student@example.com"
},
"rate": {
"score": 2.5,
"comment": "Please revise question 3 and resubmit."
}
}
}