Added comments to highlight EventClient api missmatches

Author: IgorChvyrov-sm

src/conductor/asyncio_client/event/event_client.py

@@ -94,6 +94,8 @@ async def add_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> None
         await event_client.add_event_handler_tag("workflow_trigger", tags)
         ```
         """
+        # Note: Async API uses (name=name, tag=tags) keyword args to match the server signature.
+        # Sync API uses (tags, name) positional args due to swagger-codegen parameter ordering.
         return await self.client.put_tag_for_event_handler(name=name, tag=tags)
 
     async def remove_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> None:
@@ -122,4 +124,6 @@ async def remove_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> N
         await event_client.remove_event_handler_tag("workflow_trigger", tags_to_remove)
         ```
         """
+        # Note: Async API uses (name=name, tag=tags) keyword args to match the server signature.
+        # Sync API uses (tags, name) positional args due to swagger-codegen parameter ordering.
         return await self.client.delete_tag_for_event_handler(name=name, tag=tags)

src/conductor/asyncio_client/orkes/orkes_event_client.py

@@ -233,6 +233,8 @@ async def add_event_handler_tag(
         await event_client.add_event_handler_tag("workflow_trigger", tags)
         ```
         """
+        # Note: Async API uses (name=name, tag=tags) keyword args to match the server signature.
+        # Sync API uses (tags, name) positional args due to swagger-codegen parameter ordering.
         return await self.event_api.put_tag_for_event_handler(name=name, tag=tags)
 
     async def remove_event_handler_tag(
@@ -263,6 +265,8 @@ async def remove_event_handler_tag(
         await event_client.remove_event_handler_tag("workflow_trigger", tags_to_remove)
         ```
         """
+        # Note: Async API uses (name=name, tag=tags) keyword args to match the server signature.
+        # Sync API uses (tags, name) positional args due to swagger-codegen parameter ordering.
         return await self.event_api.delete_tag_for_event_handler(name=name, tag=tags)
 
     # Queue Configuration Operations

src/conductor/client/event/event_client.py

@@ -90,6 +90,8 @@ def add_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> None:
         event_client.add_event_handler_tag("workflow_trigger", tags)
         ```
         """
+        # Note: Sync API uses (tags, name) parameter order due to swagger-codegen placing
+        # body params before path params. Async API uses (name=name, tag=tags) instead.
         return self.client.put_tag_for_event_handler(tags, name)
 
     def remove_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> None:
@@ -118,4 +120,6 @@ def remove_event_handler_tag(self, name: str, tags: List[TagAdapter]) -> None:
         event_client.remove_event_handler_tag("workflow_trigger", tags_to_remove)
         ```
         """
+        # Note: Sync API uses (tags, name) parameter order due to swagger-codegen placing
+        # body params before path params. Async API uses (name=name, tag=tags) instead.
         return self.client.delete_tag_for_event_handler(tags, name)

src/conductor/client/orkes/orkes_event_client.py

@@ -234,6 +234,8 @@ def add_event_handler_tag(
         event_client.add_event_handler_tag("workflow_trigger", tags)
         ```
         """
+        # Note: Sync API uses (tags, name) parameter order due to swagger-codegen placing
+        # body params before path params. Async API uses (name=name, tag=tags) instead.
         return self.eventResourceApi.put_tag_for_event_handler(tags, name)
 
     def remove_event_handler_tag(
@@ -264,6 +266,8 @@ def remove_event_handler_tag(
         event_client.remove_event_handler_tag("workflow_trigger", tags_to_remove)
         ```
         """
+        # Note: Sync API uses (tags, name) parameter order due to swagger-codegen placing
+        # body params before path params. Async API uses (name=name, tag=tags) instead.
         return self.eventResourceApi.delete_tag_for_event_handler(tags, name)
 
     # Queue Configuration Operations