Spin type in es query op to literal

src/mp_api/routes/electronic_structure/query_operators.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import Optional, Union, Literal
 from fastapi import Query, HTTPException
 from pymatgen.analysis.magnetism.analyzer import Ordering
 from pymatgen.electronic_structure.core import Spin, OrbitalType
@@ -158,8 +158,9 @@ def query(
         projection_type: Optional[DOSProjectionType] = Query(
             None, description="Projection type for the density of states data.",
         ),
-        spin: Optional[Spin] = Query(
-            None, description="Spin channel for density of states data.",
+        spin: Optional[Union[Literal["1", "-1"], Spin]] = Query(
+            None,
+            description="Spin channel for density of states data. '1' corresponds to spin up.",
         ),
         element: Optional[Element] = Query(
             None, description="Element type for projected density of states data.",
@@ -186,6 +187,9 @@ def query(
 
         crit = defaultdict(dict)  # type: dict
 
+        if isinstance(spin, str):
+            spin = Spin(int(spin))
+
         if projection_type is not None:
             if spin is None:
                 raise HTTPException(