Coach Update Requests

List Coach Update Requests

Endpoint

• Method: GET
• URL: /v1/coach/coach-update-requests

Request Headers

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

Query Parameters

Parameter	Type	Description	Required
status	string	Filter by status (PENDING, APPROVED, REJECTED)	No
is_checked	string	Filter by is checked	No
created_at	string	Filter by created date	No
page	number	Page number for pagination	No
per_page	number	Number of items per page	No

Success Response

{
    "success": true,
    "message": "تم جلب طلبات التحديث بنجاح",
    "data": {
        "requests": [
            {
                "id": "uuid",
                "status": "مقبول",
                "number": "number",
                "oldData": {
                    "new_certificate_files": [
                        {
                            "file_url": "https://image.png",
                            "name": "image.png"
                        }
                    ]
                },
                "newData": {
                    "new_certificate_files": [
                        {
                            "file_url": "https://تست.pdf",
                            "name": "تست.pdf"
                        },
                        {
                            "file_url": "https://image.jpeg",
                            "name": "image.jpeg"
                        }
                    ]
                },
                "createdAt": "30/01/2025"
            },
        ],
    },
    "statusCode": 200
}

Get Coach Update Request

Endpoint

• Method: GET
• URL: /v1/coach/coach-update-requests/{id}

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	Request ID	Yes

Success Response

{
    "success": true,
    "message": "تم جلب طلب التحديث بنجاح",
    "data": {
        "id": "uuid",
        "status": "مقبول",
        "number": 0000001,
        "coachId": "uuid",
        "createdAt": "30/01/2025",
        "updatedAt": "30/01/2025",
        "fields": [
            {
                "id": "firstName",
                "fieldName": "الاسم الأول",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
            {
                "id": "middleName",
                "fieldName": "اسم الأب",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
        ]
    },
    "statusCode": 200
}

Create Coach Update Request

Endpoint

• Method: POST
• URL: /v1/coach/coach-update-requests

Request Headers

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

Request Body

All Mentor Personal And Professional Information Attributes

Success Response

{
    "success": true,
    "message": "تم جلب طلب التحديث بنجاح",
    "data": {
        "id": "uuid",
        "status": "مقبول",
        "number": 0000001,
        "coachId": "uuid",
        "createdAt": "30/01/2025",
        "updatedAt": "30/01/2025",
        "fields": [
            {
                "id": "firstName",
                "fieldName": "الاسم الأول",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
            {
                "id": "middleName",
                "fieldName": "اسم الأب",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
        ]
    },
    "statusCode": 200
}

Update Coach Update Request

Endpoint

• Method: POST
• URL: /v1/coach/coach-update-requests/{id}

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	Request ID	Yes

Request Body

All Mentor Personal And Professional Information Attributes

Success Response

{
    "success": true,
    "message": "تم جلب طلب التحديث بنجاح",
    "data": {
        "id": "uuid",
        "status": "مقبول",
        "number": 0000001,
        "coachId": "uuid",
        "createdAt": "30/01/2025",
        "updatedAt": "30/01/2025",
        "fields": [
            {
                "id": "firstName",
                "fieldName": "الاسم الأول",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
            {
                "id": "middleName",
                "fieldName": "اسم الأب",
                "newData": null,
                "oldData": null,
                "status": "بانتظار المراجعة",
                "rejectReason": null
            },
        ]
    },
    "statusCode": 200
}

Error Responses

Request Not Found (404)

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

Important Notes

• Coach update requests are used to request changes to coach level or categories
• Only pending requests can be cancelled
• Each coach can have only one pending request of each type
• Requests are reviewed by administrators
• The old value is automatically captured when creating a request
• Requests are tracked with timestamps for auditing
• Status changes are notified to the coach
• Request history is maintained for reference
• Validation ensures data integrity and business rules
• Requests can be filtered and paginated for efficient management