The feedback form was revamped in v2.2. The body now collects 11 user-supplied responses (5 ratings, 3 yes/maybe/no answers, 5 optional free-text fields). The legacy valuable_metric enum was replaced with a free-text most_valuable field; difficulty_level now uses a 1–5 scale (was 1–3). Older feedback rows in Mongo retain their original shape and are readable as-is — only new submissions follow the new schema.
Submit Feedback
Submit feedback for a completed session. The case study is resolved from the session automatically. If the underlying case study has been deleted, the request is rejected.
Authentication
Requires a valid access token (any authenticated user).
Request body
Identifier
The session ID to submit feedback for. Must be a valid 24-character ObjectId.
Ratings (1–5, all required)
How would you rate this session?
How challenging was this case study?
How clear were the agent’s responses?
overall_experience_rating
How would you rate your overall experience with MIND v2?
How would you rate the interface design?
Yes / Maybe / No (all required)
Was MIND helpful in guiding your learning or decisions? yes, maybe, or no.
Did the avatar make the case study feel more personal or relatable? yes, maybe, or no.
Would you recommend MIND to others? yes, maybe, or no.
Free text (all optional, max 2000 characters each)
What did you find confusing or difficult?
What would you like to see improved as a student user?
What did you like or dislike about interacting with the avatar?
Any other feedback, issues, or ideas?
Example request
curl -X POST https://staging-be.mind.miva.university/v1/feedbacks \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"session_id": "6651a1b2c3d4e5f6a7b8c9d0",
"rating": 4,
"difficulty_level": 4,
"clarity_level": 5,
"overall_experience_rating": 5,
"interface_rating": 4,
"helpful_for_learning": "yes",
"avatar_relatable": "maybe",
"would_recommend": "yes",
"most_valuable": "Being challenged to defend my reasoning instead of just receiving the answer.",
"confusing_or_difficult": "The opening question was a lot to process at once.",
"improvements": "A short scenario summary on the case study card before starting.",
"avatar_feedback": "The voice felt natural; the personality was on point.",
"additional_info": "Loved it overall."
}'
Response
{
"success": true,
"data": {
"id": "6650f1a2b3c4d5e6f7a8b9c0",
"session_id": "6651a1b2c3d4e5f6a7b8c9d0",
"user_id": "6650a1b2c3d4e5f6a7b8c9d0",
"case_study_id": "6650c3d4e5f6a7b8c9d0e1f2",
"rating": 4,
"difficulty_level": 4,
"clarity_level": 5,
"overall_experience_rating": 5,
"interface_rating": 4,
"helpful_for_learning": "yes",
"avatar_relatable": "maybe",
"would_recommend": "yes",
"most_valuable": "Being challenged to defend my reasoning instead of just receiving the answer.",
"confusing_or_difficult": "The opening question was a lot to process at once.",
"improvements": "A short scenario summary on the case study card before starting.",
"avatar_feedback": "The voice felt natural; the personality was on point.",
"additional_info": "Loved it overall.",
"created_at": "2026-04-30T14:30:00Z"
},
"message": "Feedback submitted successfully"
}
Error responses
| Status | Code | Condition |
|---|
404 | NOT_FOUND | Session not found, or the underlying case study has been deleted |
409 | CONFLICT | Feedback already submitted for this session |
422 | VALIDATION_ERROR | Invalid input (rating out of range, bad ObjectId format, missing required field, invalid yes/maybe/no value) |
