Overview

When a session is submitted for scoring using Feedback Aide, the session status is set to Pending Scoring while responses are queued for evaluation. As each response is evaluated by Feedback Aide, a feedbackaide_session_uuid is created and associated with that response. Once all responses in the session have been scored, the session status is updated to Completed.

This article explains how to work with Feedback Aide-scored sessions using the Data API.

Session Status: Pending Scoring

When a session is submitted for scoring via Feedback Aide, the session status transitions to Pending Scoring. This status indicates that the session contains responses that are queued and waiting to be scored by Feedback Aide. Once all responses in the session have been scored, the session status is updated to Completed.

Retrieving the Feedback Aide Session UUID

To access Feedback Aide feedback or load the Feedback Aide UI for a grader, you need the feedbackaide_session_uuid. This UUID is returned in the response data when you query sessions that have been scored with Feedback Aide.

Use the GET /sessions/responses endpoint to retrieve the feedbackaide_session_uuid:

{
    "session_id": ["your-session-id"]
}

The response includes the feedbackaide_session_uuid for each response that was scored with Feedback Aide:

{
    "data": [{
        "session_id": "your-session-id",
        "status": "Completed",
        "responses": [{
            "response_id": "response-123",
            "feedbackaide_session_uuid": "fa-uuid-456",
            "score": 3,
            "max_score": 5
        }]
    }]
}

Initializing the Feedback Aide UI

Once you have retrieved the feedbackaide_session_uuid from the Data API, you can use it to initialize the Feedback Aide UI for human graders to review and modify feedback.

For more information on initializing a feedback session with the UUID, see the feedbackSession() method article.

const feedbackSession = await feedbackApp.feedbackSession(
    { /* security token */ },
    {
        state: 'review',
        session_uuid: 'fa-uuid-456', // The feedbackaide_session_uuid from Data API
        // ... other options
    }
);

Important: Score Synchronization

When a grader modifies scores in the Feedback Aide UI, those changes are not automatically synchronized to Learnosity. They are saved only in the Feedback Aide system.

This can create two sources of truth for scores:

• The score stored in the Data API (from the initial Feedback Aide evaluation).
• The updated score in Feedback Aide (after human review).

To maintain score consistency, when a score is changed by a human grader in Feedback Aide:

• Starting with v2026.3.LTS, call the Data API Session Response Score Grading endpoint when a grader clicks "Submit to Student" in the Feedback Aide UI. This ensures that the score in the Data API reflects the final graded score.
• For earlier versions, call the Data API GET /sessions/responses or GET /sessions/scores endpoints. However, because this endpoint does not support grader-associated manual scores, it cannot synchronize scores and feedback for display in the Grading API.

Example workflow:

1. Retrieve the session and feedbackaide_session_uuid from Data API.
2. Initialize Feedback Aide UI with the UUID for human review.
3. When the grader submits the final score, capture the updated score.
4. Use Session Response Score Grading Data API endpoint to synchronize the final score with the Data API.

Mixed AI/Manual-Scored Scenarios

If your activity has both autoscored, manually graded items, and Feedback Aide-scored items, you may want to display all grades and feedback to the learner in one review page using Grading API.

To do so, use the Data API GET /sessions/responses/feedback endpoint to save feedback. If the score is adjusted, use the UPDATE /sessions/responses/feedback and UPDATE /sessions/responses/scores/grading endpoints with the same grader_id.

Example workflow (no human intervention):

1. Retrieve the session and feedbackaide_session_uuid from Data API.
2. Call the Feedback Aide RESTful endpoint with the UUID to retrieve the generated feedback.
3. Use /sessions/responses/feedback to set the feedback.
4. Initialize Grading API in review mode to show the Feedback Aide generated scores and feedback in line with other details.

Example workflow (human intervention):

1. Retrieve the session and feedbackaide_session_uuid from Data API.
2. Initialize Feedback Aide UI with the UUID for human review.
3. When the grader submits the final score and feedback, capture the updated score.
4. Use the UPDATE /sessions/responses/scores/grading and UPDATE /sessions/responses/feedback Data API endpoints with the same grader_id to synchronize the final score and feedback with the Data API.