chore: add requested changes in PR

Author: matiasperrone

app/Http/Controllers/Apis/Protected/Main/OAuth2GroupsApiController.php

@@ -103,7 +103,7 @@ public function __construct
                 name: 'expand',
                 in: 'query',
                 required: false,
-                description: 'Comma-separated list of related resources to include. Available relations: members',
+                description: 'Comma-separated list of related resources to include. Available relations: members (expands member IDs to full member objects)',
                 schema: new OA\Schema(type: 'string', example: 'members')
             ),
         ],

app/Swagger/Models/GroupSchema.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+
+#[OA\Schema(
+    schema: 'Group',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1, description: 'Unique identifier'),
+        new OA\Property(property: 'created', type: 'integer', example: 1630500518, description: 'Creation timestamp (Unix epoch)'),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1630500518, description: 'Last modification timestamp (Unix epoch)'),
+        new OA\Property(property: 'title', type: 'string', example: 'Administrators', description: 'Group title'),
+        new OA\Property(property: 'description', type: 'string', example: 'System administrators group', description: 'Group description', nullable: true),
+        new OA\Property(property: 'code', type: 'string', example: 'administrators', description: 'Unique group code'),
+        new OA\Property(
+            property: 'members',
+            type: 'array',
+            description: 'List of Member objects, only present when requested via ?expand=members',
+            items: new OA\Items(
+                ref: '#/components/schemas/Member'
+            )
+        ),
+    ]
+)]
+class GroupSchema
+{
+}

app/Swagger/schemas.php

@@ -488,4 +488,4 @@ class ChunkedFileUploadRequestSchema
 )]
 class PaginatedGroupsResponseSchema
 {
-}
+}