update api and add more features

app/Http/Requests/Promotions/UpdatePromotionStatusRequest.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Requests\Promotions;
+
+use App\Http\Requests\ApiFormRequest;
+use App\Models\StudentPromotionRecord;
+use Illuminate\Validation\Rule;
+
+class UpdatePromotionStatusRequest extends ApiFormRequest
+{
+    public function rules(): array
+    {
+        return [
+            'status' => ['required', 'string', Rule::in(StudentPromotionRecord::ALL_STATUSES)],
+            'force' => ['nullable', 'boolean'],
+            'notes' => ['nullable', 'string', 'max:500'],
+        ];
+    }
+}