oas

Author: pcrespov

api/specs/web-server/_projects_groups.py

@@ -7,6 +7,7 @@
 from typing import Annotated
 
 from fastapi import APIRouter, Depends, status
+from models_library.api_schemas_webserver.groups import ProjectShare
 from models_library.generics import Envelope
 from simcore_service_webserver._meta import API_VTAG
 from simcore_service_webserver.projects._controller._rest_schemas import (
@@ -16,7 +17,6 @@
     ProjectShareAccepted,
     _ProjectsGroupsBodyParams,
     _ProjectsGroupsPathParams,
-    _ProjectShare,
 )
 from simcore_service_webserver.projects._groups_service import ProjectGroupGet
 
@@ -38,7 +38,7 @@
 )
 async def share_project(
     _path: Annotated[ProjectPathParams, Depends()],
-    _body: _ProjectShare,
+    _body: ProjectShare,
 ): ...
 
 

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

@@ -4561,14 +4561,15 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/_ProjectsGroupsBodyParams'
+              $ref: '#/components/schemas/ProjectShare'
       responses:
-        '201':
-          description: Successful Response
+        '202':
+          description: The request to share the project has been accepted, but the
+            actual sharing process has to be confirmd.
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Envelope_ProjectGroupGet_'
+                $ref: '#/components/schemas/Envelope_ProjectShareAccepted_'
   /v0/projects/{project_id}/groups/{group_id}:
     post:
       tags:
@@ -9456,6 +9457,19 @@ components:
           title: Error
       type: object
       title: Envelope[ProjectNodeServicesGet]
+    Envelope_ProjectShareAccepted_:
+      properties:
+        data:
+          anyOf:
+          - $ref: '#/components/schemas/ProjectShareAccepted'
+          - type: 'null'
+        error:
+          anyOf:
+          - {}
+          - type: 'null'
+          title: Error
+      type: object
+      title: Envelope[ProjectShareAccepted]
     Envelope_ProjectState_:
       properties:
         data:
@@ -13955,6 +13969,42 @@ components:
       required:
       - value
       title: ProjectRunningState
+    ProjectShare:
+      properties:
+        shareeEmail:
+          type: string
+          format: email
+          title: Shareeemail
+        read:
+          type: boolean
+          title: Read
+        write:
+          type: boolean
+          title: Write
+        delete:
+          type: boolean
+          title: Delete
+      type: object
+      required:
+      - shareeEmail
+      - read
+      - write
+      - delete
+      title: ProjectShare
+    ProjectShareAccepted:
+      properties:
+        shareeEmail:
+          type: string
+          format: email
+          title: Shareeemail
+        confirmationLink:
+          type: string
+          title: Confirmationlink
+      type: object
+      required:
+      - shareeEmail
+      - confirmationLink
+      title: ProjectShareAccepted
     ProjectState:
       properties:
         locked: