@@ -90,21 +90,46 @@ Get a variable::
9090 p_var = project.variables.get('key_name')
9191 g_var = group.variables.get('key_name')
9292
93+ ..note ::
94+
95+ If there are multiple variables with the same key, use ``filter `` to select
96+ the correct ``environment_scope ``. See the GitLab API docs for more
97+ information.
98+
9399Create a variable::
94100
95101 var = project.variables.create({'key': 'key1', 'value': 'value1'})
96102 var = group.variables.create({'key': 'key1', 'value': 'value1'})
97103
104+ ..note ::
105+
106+ If a variable with the same key already exists, the new variable must have a
107+ different ``environment_scope ``. Otherwise, GitLab returns a message similar
108+ to: VARIABLE_NAME has already been taken. See the GitLab API docs for more
109+ information.
110+
98111Update a variable value::
99112
100113 var.value = 'new_value'
101114 var.save()
102115 # or
103116 project.variables.update("key1", {"value": "new_value"})
104117
118+ ..note ::
119+
120+ If there are multiple variables with the same key, use ``filter `` to select
121+ the correct ``environment_scope ``. See the GitLab API docs for more
122+ information.
123+
105124Remove a variable::
106125
107126 project.variables.delete('key_name')
108127 group.variables.delete('key_name')
109128 # or
110129 var.delete()
130+
131+ ..note ::
132+
133+ If there are multiple variables with the same key, use ``filter `` to select
134+ the correct ``environment_scope ``. See the GitLab API docs for more
135+ information.