docs: variables: add note about filter for updating

JohnVillalovos · JohnVillalovos · commit f5e80cf57347 · 2024-07-13T12:39:02.000-07:00
Add a note about using `filter` when updating a variable. Closes: #2835 Closes: #1387
diff --git a/docs/gl_objects/variables.rst b/docs/gl_objects/variables.rst
@@ -102,9 +102,19 @@ Update a variable value::
     # or
     project.variables.update("key1", {"value": "new_value"})
 
+.. note::
+
+   If there are multiple variables with the same key, use ``filter`` to select
+   the correct environment_scope. See the GitLab API docs for more information.
+
 Remove a variable::
 
     project.variables.delete('key_name')
     group.variables.delete('key_name')
     # or
     var.delete()
+
+.. note::
+
+   If there are multiple variables with the same key, use ``filter`` to select
+   the correct environment_scope. See the GitLab API docs for more information.
