python-gitlab
diff --git a/Collapse file
‎docs/gl_objects/iterations.rst‎
Copy file name to clipboardExpand all lines: docs/gl_objects/iterations.rst
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎docs/gl_objects/iterations.rst‎
Copy file name to clipboardExpand all lines: docs/gl_objects/iterations.rst
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎gitlab/v4/objects/iterations.py‎
Copy file name to clipboardExpand all lines: gitlab/v4/objects/iterations.py
+29-2Lines changed: 29 additions & 2 deletions b/Collapse file
‎gitlab/v4/objects/iterations.py‎
Copy file name to clipboardExpand all lines: gitlab/v4/objects/iterations.py
+29-2Lines changed: 29 additions & 2 deletions
@@ -31,3 +31,13 @@ List iterations for a project's ancestor groups::
 List iterations for a group::
 
     iterations = group.iterations.list()
+
+Unavailable filters or keyword conflicts::
+    
+    In case you are trying to pass a parameter that collides with a python
+    keyword (i.e. `in`) or with python-gitlab's internal arguments, you'll have
+    to use the `query_parameters` argument:
+
+    ```
+    group.iterations.list(query_parameters={"in": "title"}) 
+    ```
@@ -1,3 +1,4 @@
+from gitlab import types
 from gitlab.base import RESTManager, RESTObject
 from gitlab.mixins import ListMixin
 
@@ -16,11 +17,37 @@ class GroupIterationManager(ListMixin, RESTManager):
     _path = "/groups/{group_id}/iterations"
     _obj_cls = GroupIteration
     _from_parent_attrs = {"group_id": "id"}
-    _list_filters = ("state", "search", "include_ancestors")
+    # When using the API, the "in" keyword collides with python's "in" keyword
+    # raising a SyntaxError.
+    # For this reason, we have to use the query_parameters argument:
+    # group.iterations.list(query_parameters={"in": "title"})
+    _list_filters = (
+        "include_ancestors",
+        "include_descendants",
+        "in",
+        "search",
+        "state",
+        "updated_after",
+        "updated_before",
+    )
+    _types = {"in": types.ArrayAttribute}
 
 
 class ProjectIterationManager(ListMixin, RESTManager):
     _path = "/projects/{project_id}/iterations"
     _obj_cls = GroupIteration
     _from_parent_attrs = {"project_id": "id"}
-    _list_filters = ("state", "search", "include_ancestors")
+    # When using the API, the "in" keyword collides with python's "in" keyword
+    # raising a SyntaxError.
+    # For this reason, we have to use the query_parameters argument:
+    # project.iterations.list(query_parameters={"in": "title"})
+    _list_filters = (
+        "include_ancestors",
+        "include_descendants",
+        "in",
+        "search",
+        "state",
+        "updated_after",
+        "updated_before",
+    )
+    _types = {"in": types.ArrayAttribute}