updates OAS

Author: pcrespov

packages/models-library/src/models_library/api_schemas_webserver/groups.py

@@ -286,14 +286,24 @@ class GroupUserAdd(InputSchema):
     """
 
     uid: UserID | None = None
-    email: LowerCaseEmailStr | None = None
+    email: Annotated[
+        LowerCaseEmailStr | None,
+        Field(
+            description="Accessible only if the user has opted to share their email in privacy settings"
+        ),
+    ] = None
 
     _check_uid_or_email = model_validator(mode="after")(
         create__check_only_one_is_set__root_validator(["uid", "email"])
     )
 
     model_config = ConfigDict(
-        json_schema_extra={"examples": [{"uid": 42}, {"email": "[email protected]"}]}
+        json_schema_extra={
+            "examples": [
+                {"uid": 42},
+                {"email": "[email protected]"},
+            ]
+        }
     )
 
 

services/web/server/src/simcore_service_webserver/api/v0/openapi.yaml

@@ -9917,6 +9917,8 @@ components:
             format: email
           - type: 'null'
           title: Email
+          description: Accessible only if the user has opted to share their email
+            in privacy settings
       type: object
       title: GroupUserAdd
       description: "Identify the user with either `email` or `uid` \u2014 only one."
@@ -9928,41 +9930,48 @@ components:
           - type: 'null'
           title: Id
           description: the user id
+        userName:
+          type: string
+          maxLength: 100
+          minLength: 1
+          title: Username
+        gid:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Gid
+          description: the user primary gid
         login:
           anyOf:
           - type: string
             format: email
           - type: 'null'
           title: Login
-          description: the user login email
+          description: the user's email, if privacy settings allows
         first_name:
           anyOf:
           - type: string
           - type: 'null'
           title: First Name
-          description: the user first name
+          description: If privacy settings allows
         last_name:
           anyOf:
           - type: string
           - type: 'null'
           title: Last Name
-          description: the user last name
+          description: If privacy settings allows
         gravatar_id:
           anyOf:
           - type: string
           - type: 'null'
           title: Gravatar Id
           description: the user gravatar id hash
-        gid:
-          anyOf:
-          - type: string
-          - type: 'null'
-          title: Gid
-          description: the user primary gid
+          deprecated: true
         accessRights:
           $ref: '#/components/schemas/GroupAccessRights'
       type: object
       required:
+      - userName
       - accessRights
       title: GroupUserGet
       example: