René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Fetching variable with environment scope raises 409 complaining about multiple variables with same key","articleBody":"\n\n## Description of the problem, including code/CLI snippet\n\nWhen attempting to fetch a project variable with a specific `environment_scope` using the python-gitlab API (v5.6.0) against GitLab server (17.6.5-ee), the documented and intuitive approaches do not work. Specifically, neither passing `environment_scope` nor `filter_environment_scope` as arguments to `ProjectVariableManager.get()` resolves the error `409: There are multiple variables with provided parameters. Please use 'filter[environment_scope]'` even when only two variables exist with unique environment scopes.\n\nExample (all fail with 409 error):\n\n```\nsrc.variables.get(\"PUBLISH_TIMEOUT\", \"*\")\nsrc.variables.get(\"PUBLISH_TIMEOUT\", environment_scope=\"*\")\nsrc.variables.get(\"PUBLISH_TIMEOUT\", filter_environment_scope=\"*\")\n```\n\nThe only way to successfully fetch the correct variable is by using the undocumented `query_parameters` argument, as discovered by reading the source code:\n\n```\nsrc.variables.get(\np.key,\nquery_parameters={\"filter[environment_scope]\": p.environment_scope}\n)\n```\n\nThis workaround is not documented and the error message does not guide the user to this solution. The documentation and exception message should be updated to clarify the correct usage.\n\n## Expected Behavior\n\nPassing either `environment_scope` or `filter_environment_scope` as an argument to `ProjectVariableManager.get()` should allow selection of the correct variable when multiple variables share the same key but have different environment scopes, as described in the GitLab API documentation. The library should transparently handle the filter parameter, or at least document the correct usage.\n\n## Actual Behavior\n\nPassing `environment_scope` or `filter_environment_scope` as arguments to `get()` results in a 409 error from the API:\n\n```\ngitlab.exceptions.GitlabGetError: 409: There are multiple variables with provided parameters. Please use 'filter[environment_scope]'\n```\n\nThe only way to successfully retrieve the variable is by passing the filter as a `query_parameters` dictionary, which is not documented (at least, not in the places where the documentation would be of use):\n\n```\nsrc.variables.get(\np.key,\nquery_parameters={\"filter[environment_scope]\": p.environment_scope}\n)\n```\n\n## Specifications\n\n- python-gitlab version: 5.6.0\n- Gitlab server version (or gitlab.com): v17.6.5-ee\n","author":{"url":"https://github.com/elucify","@type":"Person","name":"elucify"},"datePublished":"2025-05-21T18:47:14.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":6},"url":"https://github.com/3202/python-gitlab/issues/3202"}