Refactors conversation endpoints to use query helpers

Switches to using a query parameter utility for improved validation
and simplifies endpoint signatures. Updates OpenAPI spec to clarify
request body requirements and relaxes query param constraints to
offer greater flexibility in API usage.

Author: matusdrobuliak66

api/specs/web-server/_conversations.py

@@ -11,6 +11,7 @@
 
 from typing import Annotated
 
+from _common import as_query
 from fastapi import APIRouter, Depends, status
 from models_library.api_schemas_webserver.conversations import (
     ConversationMessagePatch,
@@ -74,8 +75,8 @@ async def list_conversations(
 )
 async def update_conversation(
     _params: Annotated[ConversationPathParams, Depends()],
-    _body: Annotated[ConversationPatch, Depends()],
-    _query: Annotated[_GetConversationsQueryParams, Depends()],
+    _body: ConversationPatch,
+    _query: Annotated[as_query(_GetConversationsQueryParams), Depends()],
 ): ...
 
 
@@ -85,7 +86,7 @@ async def update_conversation(
 )
 async def delete_conversation(
     _params: Annotated[ConversationPathParams, Depends()],
-    _query: Annotated[_GetConversationsQueryParams, Depends()],
+    _query: Annotated[as_query(_GetConversationsQueryParams), Depends()],
 ): ...
 
 
@@ -95,7 +96,7 @@ async def delete_conversation(
 )
 async def get_conversation(
     _params: Annotated[ConversationPathParams, Depends()],
-    _query: Annotated[_GetConversationsQueryParams, Depends()],
+    _query: Annotated[as_query(_GetConversationsQueryParams), Depends()],
 ): ...
 
 
@@ -121,7 +122,7 @@ async def create_conversation_message(
 )
 async def list_conversation_messages(
     _params: Annotated[ConversationPathParams, Depends()],
-    _query: Annotated[_ListConversationMessageQueryParams, Depends()],
+    _query: Annotated[as_query(_ListConversationMessageQueryParams), Depends()],
 ): ...
 
 

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

@@ -593,19 +593,17 @@ paths:
           type: string
           format: uuid
           title: Conversation Id
-      - name: name
-        in: query
-        required: false
-        schema:
-          anyOf:
-          - type: string
-          - type: 'null'
-          title: Name
       - name: type
         in: query
         required: true
         schema:
           $ref: '#/components/schemas/ConversationType'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ConversationPatch'
       responses:
         '200':
           description: Successful Response
@@ -704,16 +702,13 @@ paths:
         required: false
         schema:
           type: integer
-          maximum: 50
-          minimum: 1
           default: 20
           title: Limit
       - name: offset
         in: query
         required: false
         schema:
           type: integer
-          minimum: 0
           default: 0
           title: Offset
       responses:
@@ -10210,6 +10205,15 @@ components:
       - MESSAGE
       - NOTIFICATION
       title: ConversationMessageType
+    ConversationPatch:
+      properties:
+        name:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Name
+      type: object
+      title: ConversationPatch
     ConversationRestGet:
       properties:
         conversationId: