From a66a936e2cd9201e8803482e154fce2b89f585f0 Mon Sep 17 00:00:00 2001
From: Ni-zav <ni-zav@users.noreply.github.com>
Date: Fri, 27 Feb 2026 02:41:50 +0700
Subject: [PATCH] fix(api-io): serialize MultiCombo multi_select as object
 config

---
 comfy_api/latest/_io.py                       | 11 +++---
 .../multicombo_serialization_test.py          | 35 +++++++++++++++++++
 2 files changed, 42 insertions(+), 4 deletions(-)
 create mode 100644 tests-unit/comfy_api_test/multicombo_serialization_test.py

diff --git a/comfy_api/latest/_io.py b/comfy_api/latest/_io.py
index 025727071..33a29ae22 100644
--- a/comfy_api/latest/_io.py
+++ b/comfy_api/latest/_io.py
@@ -395,7 +395,6 @@ class Combo(ComfyTypeIO):
 @comfytype(io_type="COMBO")
 class MultiCombo(ComfyTypeI):
     '''Multiselect Combo input (dropdown for selecting potentially more than one value).'''
-    # TODO: something is wrong with the serialization, frontend does not recognize it as multiselect
     Type = list[str]
     class Input(Combo.Input):
         def __init__(self, id: str, options: list[str], display_name: str=None, optional=False, tooltip: str=None, lazy: bool=None,
@@ -408,12 +407,16 @@ class MultiCombo(ComfyTypeI):
             self.default: list[str]
 
         def as_dict(self):
-            to_return = super().as_dict() | prune_dict({
-                "multi_select": self.multiselect,
+            # Frontend expects `multi_select` to be an object config (not a boolean).
+            # Keep top-level `multiselect` from Combo.Input for backwards compatibility.
+            return super().as_dict() | prune_dict({
+                "multi_select": prune_dict({
+                    "placeholder": self.placeholder,
+                    "chip": self.chip,
+                }) if self.multiselect else None,
                 "placeholder": self.placeholder,
                 "chip": self.chip,
             })
-            return to_return
 
 @comfytype(io_type="IMAGE")
 class Image(ComfyTypeIO):
diff --git a/tests-unit/comfy_api_test/multicombo_serialization_test.py b/tests-unit/comfy_api_test/multicombo_serialization_test.py
new file mode 100644
index 000000000..9e4fecdd0
--- /dev/null
+++ b/tests-unit/comfy_api_test/multicombo_serialization_test.py
@@ -0,0 +1,35 @@
+from comfy_api.latest._io import MultiCombo
+
+
+def test_multicombo_serializes_multi_select_as_object():
+    multi_combo = MultiCombo.Input(
+        id="providers",
+        options=["a", "b", "c"],
+        default=["a"],
+    )
+
+    serialized = multi_combo.as_dict()
+
+    assert serialized["multiselect"] is True
+    assert "multi_select" in serialized
+    assert serialized["multi_select"] == {}
+
+
+def test_multicombo_serializes_multi_select_with_placeholder_and_chip():
+    multi_combo = MultiCombo.Input(
+        id="providers",
+        options=["a", "b", "c"],
+        default=["a"],
+        placeholder="Select providers",
+        chip=True,
+    )
+
+    serialized = multi_combo.as_dict()
+
+    assert serialized["multiselect"] is True
+    assert serialized["multi_select"] == {
+        "placeholder": "Select providers",
+        "chip": True,
+    }
+    assert serialized["placeholder"] == "Select providers"
+    assert serialized["chip"] is True