fixup! refactor: enhance form update method with validation and permission checks

Signed-off-by: Christian Hartmann <chris-hartmann@gmx.de>

Author: Chartman123

lib/Controller/ApiController.php

@@ -250,7 +250,7 @@ public function getForm(int $formId): DataResponse {
 	 *
 	 * @param int $formId The ID of the form to update.
 	 * @param array<string, mixed> $keyValuePairs Key-value pairs to update on the form.
-	 * @return DataResponse<Http::STATUS_OK, int|string, array<{}>>
+	 * @return DataResponse<Http::STATUS_OK, int|string, array{}>
 	 * @throws OCSBadRequestException If the new form owner cannot be found.
 	 * @throws OCSForbiddenException If the input is empty, forbidden keys are present, or the user is not allowed to modify the form.
 	 * @throws OCSNotFoundException If the form is not found.

openapi.json

@@ -1039,6 +1039,44 @@
                     }
                 ],
                 "responses": {
+                    "200": {
+                        "description": "Returns the ID of the updated form",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "required": [
+                                        "ocs"
+                                    ],
+                                    "properties": {
+                                        "ocs": {
+                                            "type": "object",
+                                            "required": [
+                                                "meta",
+                                                "data"
+                                            ],
+                                            "properties": {
+                                                "meta": {
+                                                    "$ref": "#/components/schemas/OCSMeta"
+                                                },
+                                                "data": {
+                                                    "oneOf": [
+                                                        {
+                                                            "type": "integer",
+                                                            "format": "int64"
+                                                        },
+                                                        {
+                                                            "type": "string"
+                                                        }
+                                                    ]
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    },
                     "400": {
                         "description": "If the new form owner cannot be found.",
                         "content": {