Skip to main content

Overview

Update the feedback score for notes associated with a specific appointment in MediSync. This endpoint allows you to set or modify the feedback score that represents user ratings or quality assessments for the clinical documentation.
Feedback Score Update: This endpoint updates only the feedback_score field of the notes. Other fields remain unchanged. The feedback score can be used to track quality ratings or user satisfaction.

Authentication

curl -X PUT \
  'https://api.medisync.com/notes/feedback/apt_abc123?uid=doc_xyz789' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "feedback_score": 4.5
  }'

Path Parameters

id
string
required
The appointment ID to update the feedback score for

Query Parameters

uid
string
required
The user ID of the healthcare provider updating the feedback score

Body Parameters

feedback_score
number
The feedback score to set for the notes (will preserve existing value if not provided)

Response

success
boolean
Indicates if the operation was successful
data
object
The updated notes object with the new feedback score
error
string
Error message if the operation failed

Example Response

{
  "success": true,
  "data": {
    "_id": "notes_def456",
    "appointment_id": "apt_abc123",
    "notes": "Patient presented with chest pain. Physical examination revealed no acute distress.",
    "summary": "Chest pain evaluation - normal findings",
    "feedback_score": 4.5,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T16:20:00.000Z"
  }
}

Behavior Notes

  • Appointment-Based Update: The endpoint finds notes by appointment ID and updates the feedback score
  • Partial Update: Only the feedback_score field is updated; other fields remain unchanged
  • Automatic Timestamps: The updatedAt field is automatically updated when the feedback score is modified
  • Preserves Existing Data: If feedback_score is not provided in the request, the existing value is preserved

Status Codes

  • 200 - Feedback score updated successfully
  • 400 - Invalid request data or database error
  • 404 - Notes not found for the specified appointment