Skip to main content
POST
/
assessment-items
/
{identifier}
/
process-response
Process a response for an assessment item
curl --request POST \
  --url https://qti.alpha-1edtech.ai/api/assessment-items/{identifier}/process-response \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "response": "<string>"
}
'
{
  "score": 123,
  "feedback": {
    "identifier": "<string>",
    "value": "<string>"
  },
  "isCorrect": true,
  "requiresAsyncGrading": true,
  "graderUrl": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

identifier
string
required

Assessment item identifier

Body

application/json
identifier
string
required

Unique identifier for the entity on the service provider.

response
required

The response to the assessment item for Free Response Question grading using AI

Response

Response processed successfully

Response processing result containing the calculated score and feedback for a candidate's response to an assessment item.

score
number | null
required

Numerical score for the response. Returns 1.0 for correct answers, 0.0 for incorrect answers, or a decimal value (0.0-1.0) for AI-graded extended text responses. Null when the question requires async grading (requiresAsyncGrading=true).

feedback
object
required

Structured feedback information containing both machine-readable identifier and human-readable message.

isCorrect
boolean | null

Whether the response is correct. Null when the question requires async grading.

requiresAsyncGrading
boolean

When true, the response has been submitted for asynchronous AI grading. Score and isCorrect will be null until grading completes.

graderUrl
string

The URL of the external grader service. Only present when requiresAsyncGrading is true.