Rate Session

Rate a completed session.

Rate a Session

Submit a rating and feedback for a completed session.

Endpoint

• Method: POST
• URL: /v1/coach/sessions/{id}/rate

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Path Parameters

Parameter	Type	Description	Required
id	string	Session ID	Yes

Request Body

Parameter	Type	Description	Required	Validation
rate	integer	Rating value (1-5)	Yes	Must be between 1 and 5
comment	string	Feedback comment	Yes	Required
rating_details	object	Detailed rating criteria	Yes	See rating details below

Rating Details Object

{
    "professionalism": 5,
    "communication": 4,
    "expertise": 5,
    "punctuality": 4,
    "overall_experience": 5
}

Success Response

{
    "success": true,
    "message": "تم حفظ البيانات بنجاح",
    "data": null,
    "statusCode": 200
}

Error Response

Session Not Found (404)

{
    "success": false,
    "message": "لم يتم العثور على الجلسة",
    "data": null,
    "statusCode": 404
}

Session Not Completed (404)

{
    "success": false,
    "message": "لا يمكن تقييم الجلسات غير المكتملة",
    "data": null,
    "statusCode": 404
}

Already Rated (404)

{
    "success": false,
    "message": "تم تقييم هذه الجلسة مسبقاً",
    "data": null,
    "statusCode": 404
}

Validation Error (422)

{
    "success": false,
    "message": "بيانات غير صالحة",
    "data": {
        "rate": [
            "التقييم يجب أن يكون بين 1 و 5"
        ],
        "comment": [
            "التعليق مطلوب"
        ],
        "rating_details": [
            "تفاصيل التقييم مطلوبة"
        ]
    },
    "statusCode": 422
}

Important Notes

• Only completed sessions can be rated
• Each session can only be rated once
• Rating values must be between 1 and 5
• Rating details include specific criteria for evaluation
• Comments are required for feedback
• Ratings are subject to review and may be pending approval