> ## Documentation Index > Fetch the complete documentation index at: https://docs.timeback.com/llms.txt > Use this file to discover all available pages before exploring further. # Process a response for an assessment item > Process a response for an assessment item. This operation validates the response and returns the result as well as the feedback identifier and the feedback value. ## OpenAPI ````yaml /openapi/beyond-ai/qti-api.yaml post /assessment-items/{identifier}/process-response openapi: 3.1.0 info: title: QTI API version: 1.0.0 description: >- A robust assessment engine implementing the QTI 3.0 specification, designed for creating, managing, and delivering educational assessments. servers: - url: https://qti.alpha-1edtech.ai/api description: Main Server security: - OAuth2: [] - MCP: [] tags: - name: Validation description: >- Validate XML strings against QTI compliant XSD files. XSD version supported is 3.0.0 (3p0) - name: Feedback description: Feedback for questions and lessons - name: Assessment Test Management description: >- Enables the management of Assessment Tests. Assessment Tests are the main entities that contain Assessment Test Parts, Sections, and Assessment Items. - name: Test Part Management description: >- Enables the management of Test Parts. Assessment Test Parts are used to group sections inside of an Assessment Test. - name: Section Management description: >- Enables the management of Sections. Assessment Sections are used to group Assessment Items. - name: Assessment Item Management description: >- Enables the management of Assessment ITems. Assessment Items are made up of QTI Interactions (e.g. questions, multiple choice, etc.). - name: Stimulus Management description: >- Enables the management of Stimuli. Stimuli are shared content pieces (text, images, audio, video) that provide context for assessment items and can be referenced by multiple questions. paths: /assessment-items/{identifier}/process-response: post: tags: - Assessment Item Management summary: Process a response for an assessment item description: >- Process a response for an assessment item. This operation validates the response and returns the result as well as the feedback identifier and the feedback value. operationId: processResponse parameters: - name: identifier description: Assessment item identifier in: path required: true schema: type: string requestBody: content: application/json: schema: type: object properties: identifier: type: string description: Unique identifier for the entity on the service provider. response: anyOf: - type: string - type: array items: type: string description: >- The response to the assessment item for Free Response Question grading using AI required: - identifier - response responses: '200': description: Response processed successfully content: application/json: schema: type: object properties: score: type: - number - 'null' description: >- 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). isCorrect: type: - boolean - 'null' description: >- Whether the response is correct. Null when the question requires async grading. feedback: type: object properties: identifier: type: string description: >- Feedback classification identifier. Typically 'correct' or 'incorrect' for standard questions, 'async-pending' for async-graded questions, or custom identifiers for more complex feedback scenarios. value: type: string description: >- Human-readable feedback message. For standard questions: 'Correct' or 'Incorrect'. For AI-graded responses: may include detailed rationale or explanation. required: - identifier - value description: >- Structured feedback information containing both machine-readable identifier and human-readable message. requiresAsyncGrading: type: boolean description: >- When true, the response has been submitted for asynchronous AI grading. Score and isCorrect will be null until grading completes. graderUrl: type: string description: >- The URL of the external grader service. Only present when requiresAsyncGrading is true. required: - score - feedback description: >- Response processing result containing the calculated score and feedback for a candidate's response to an assessment item. '404': description: Assessment item not found content: application/json: schema: type: object properties: error: type: string details: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string description: Error type identifier message: type: string description: Human-readable error message eventId: type: string description: Sentry event ID for error tracking details: type: string description: Stack trace or additional error details required: - error - message - details description: Internal server error response components: securitySchemes: OAuth2: type: oauth2 flows: clientCredentials: scopes: https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI https://purl.imsglobal.org/spec/qti/v3/scope/createput: Create and update access to QTI https://purl.imsglobal.org/spec/qti/v3/scope/delete: Delete access to QTI tokenUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token MCP: type: oauth2 flows: authorizationCode: authorizationUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/authorize tokenUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token scopes: https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI ````