fix(swagger): endpoint doc

Signed-off-by: smarcet <smarcet@gmail.com>

Author: smarcet

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

@@ -342,14 +342,17 @@ public function get($id)
     #[OA\Get(
         path: '/api/v2/users/{id}',
         summary: 'Get a user by ID',
-        description: 'Get a user by ID (only for accounts of type "SERVICE")',
+        description: 'Retrieves user details by their numeric ID.',
         operationId: 'getUserByIdV2',
-        tags: ['Users'],
+        tags: ['Users', 'V2'],
         security: [
             ['OAuth2UserSecurity' => [
                 IUserScopes::ReadAll,
             ]],
         ],
+        x: [
+            'x-required-client-type' => 'SERVICE',
+        ],
         parameters: [
             new OA\Parameter(
                 name: 'id',
@@ -380,6 +383,10 @@ public function get($id)
                 response: HttpResponse::HTTP_INTERNAL_SERVER_ERROR,
                 description: 'Server Error'
             ),
+            new OA\Response(
+                response: HttpResponse::HTTP_FORBIDDEN,
+                description: 'Forbidden - Only service accounts are allowed'
+            ),
         ]
     )]
     public function getV2($id)