chore: Add OpenAPI response annotations for forbidden and unauthorized statuses in OAuth2UserRegistrationRequestApiController

Author: matiasperrone-exo

app/Http/Controllers/Api/OAuth2/OAuth2UserRegistrationRequestApiController.php

@@ -72,6 +72,14 @@
             description: 'OK',
             content: new OA\JsonContent(ref: '#/components/schemas/PaginatedUserRegistrationRequestResponse')
         ),
+        new OA\Response(
+            response: HttpResponse::HTTP_FORBIDDEN,
+            description: 'Forbidden'
+        ),
+        new OA\Response(
+            response: HttpResponse::HTTP_UNAUTHORIZED,
+            description: 'Unauthorized'
+        ),
         new OA\Response(
             response: HttpResponse::HTTP_PRECONDITION_FAILED,
             description: 'Precondition Failed'
@@ -169,6 +177,14 @@ protected function getFilterValidatorRules(): array
                 description: 'Created',
                 content: new OA\JsonContent(ref: '#/components/schemas/UserRegistrationRequest')
             ),
+            new OA\Response(
+                response: HttpResponse::HTTP_FORBIDDEN,
+                description: 'Forbidden'
+            ),
+            new OA\Response(
+                response: HttpResponse::HTTP_UNAUTHORIZED,
+                description: 'Unauthorized'
+            ),
             new OA\Response(
                 response: HttpResponse::HTTP_BAD_REQUEST,
                 description: 'Bad Request'
@@ -261,9 +277,17 @@ public function register(){
         responses: [
             new OA\Response(
                 response: HttpResponse::HTTP_CREATED,
-                description: 'OK',
+                description: 'Updated',
                 content: new OA\JsonContent(ref: '#/components/schemas/UserRegistrationRequest')
             ),
+            new OA\Response(
+                response: HttpResponse::HTTP_FORBIDDEN,
+                description: 'Forbidden'
+            ),
+            new OA\Response(
+                response: HttpResponse::HTTP_UNAUTHORIZED,
+                description: 'Unauthorized'
+            ),
             new OA\Response(
                 response: HttpResponse::HTTP_BAD_REQUEST,
                 description: 'Bad Request'