Evaluating Attempts to Submit an Assignment
AVAILABLE WITH BUSINESS SUBSCRIPTION
Method: gradeAssignmentAttempts
Permissions to Run the Request
Account Owner, Account Administrators, Department Administrators or custom roles that allow to grade assignments.
Request Parameters
Parameter | Type | Description |
---|---|---|
token (required) | string | Access token. You can obtain a token by making a request. |
assignmentAttemptGrades (required) | AssignmentAttemptGrade[] | An array containing information about the attempts grade. |
AssignmentAttemptGrade
Parameter | Type | Description |
---|---|---|
attemptId | string | The attempt ID. |
score | int | Points from 1 to 100. |
comment | string | Comment. |
Return Values
After the request is successfully processed, the system returns an object with the following properties:
Parameter | Type | Description |
---|---|---|
success | bool | True if the enrollment has been created. |
Possible Errors
Error | Description |
InvalidArgumentException | Invalid request. |
Permission denied | The user doesn't have permission to handle the request. |
Sample Request
SoapAction: "https://%HOST%/soap/2.0/gradeAssignmentAttempts"
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap">
<soapenv:Header/>
<soapenv:Body>
<soap:GradeAssignmentAttemptsRequest>
<soap:credentials>
<soap:token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</soap:token>
</soap:credentials>
<soap:assignmentAttemptGrades>
<soap:assignmentAttemptGrade>
<soap:attemptId>b825d996-2da0-11ec-9c36-0242ac150037</soap:attemptId>
<soap:score>55</soap:score>
<soap:comment>What was nice</soap:comment>
</soap:assignmentAttemptGrade>
<soap:assignmentAttemptGrade>
<soap:attemptId>cb48025e-2db1-11ec-a60f-0242ac150037</soap:attemptId>
<soap:score>75</soap:score>
<soap:comment>What was awesome</soap:comment>
</soap:assignmentAttemptGrade>
</soap:assignmentAttemptGrades>
</soap:GradeAssignmentAttemptsRequest>
</soapenv:Body>
</soapenv:Envelope>
Sample Response
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<ns1:SuccessResult>
<ns1:success>true</ns1:success>
</ns1:SuccessResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>