Sign in
teacher_grading_decisions

POST `/api/v0/main-frontend/teacher-grading-decisions` - Creates a new teacher grading decision, overriding the points a user has received from an exercise.

Changed on
post/api/v0/main-frontend/teacher-grading-decisions

Request

  • The document declares no server URL.
  • Auth: none declared

Request body

action'FullPoints' | 'ZeroPoints' | 'CustomPoints' | 'SuspectedPlagiarism' | 'RejectAndReset' | 'UnauthorizedAiUse' | 'BadAnswer' | 'Other' required
exercise_idstring uuid required
hiddenboolean required
justificationstring nullable
manual_pointsnumber float nullable
reset_exerciseboolean required

Resets the student's progress on the exercise so they can answer it again. Independent of action, so a decision can record why the answer was rejected and still reopen it. Requires the exercise to belong to a course.

user_exercise_state_idstring uuid required

Response

Teacher grading decision created

activity_progress'Initialized' | 'Started' | 'InProgress' | 'Submitted' | 'Completed' required

Indicates what is the user's completion status for a exercise.

As close as possible to LTI's activity progress for compatibility: https://www.imsglobal.org/spec/lti-ags/v2p0#activityprogress.

course_idstring uuid nullable
created_atstring date-time required
deleted_atstring date-time nullable
exam_idstring uuid nullable
exercise_idstring uuid required
grading_progress'Failed' | 'NotReady' | 'PendingManual' | 'Pending' | 'FullyGraded' required

Tells what's the status of the grading progress for a user and exercise.

As close as possible LTI's grading progress for compatibility: https://www.imsglobal.org/spec/lti-ags/v2p0#gradingprogress

idstring uuid required
reviewing_stage'NotStarted' | 'PeerReview' | 'SelfReview' | 'WaitingForPeerReviews' | 'WaitingForManualGrading' | 'ReviewedAndLocked' | 'Locked' | 'NotAnsweredAndLocked' required

Tells what stage of reviewing the user is currently in. Used for for peer review, self review, and manual review. If an exercise does not involve reviewing, the value of this stage will always be NotStarted.

score_givennumber float nullable
selected_exercise_slide_idstring uuid nullable
updated_atstring date-time required
user_idstring uuid required

Changes

  • 8371f319f33cRevision changes
    • ▲

      added the new required request property

    • ○

      added the new BadAnswer enum value to the request property

    • ○

      added the new Other enum value to the request property

    • ○

      added the new UnauthorizedAiUse enum value to the request property

  • aa9bc7de92a3Revision changes
    • ●

      added the new NotAnsweredAndLocked enum value to the //// response property for the response status