Skip to content

List projects filtered by key=value tags. - #201

Open
ellieayla wants to merge 1 commit into
hashicorp:mainfrom
ellieayla:filter-projects-by-tag
Open

List projects filtered by key=value tags.#201
ellieayla wants to merge 1 commit into
hashicorp:mainfrom
ellieayla:filter-projects-by-tag

Conversation

@ellieayla

@ellieayla ellieayla commented Aug 24, 2026

Copy link
Copy Markdown

Description

The TFE project list api supports filter[i][key/value] query parameters, documented since v1.2.x and working since at least v202507-1.

Expose tag filter via new field in ProjectListOptions, and serialize it to query parameters in Projects.list().

Testing plan

Unittests added to ensure query parameters are serialized as expected.

tests/units/test_project.py::TestProjects::test_list_projects_by_tags_query_params_serialized_success PASSED
tests/units/test_project.py::TestProjects::test_list_projects_by_name_query_params_serialized_success PASSED

External links

Output from tests

Added 2 unittests.

Including output from tests may require access to a TFE instance. Ignore this section if you have no environment to test against.

Rollback Plan

Changes to Security Controls

PCI review checklist

  • I have documented a clear reason for, and description of, the change I am making.

  • If applicable, I've documented a plan to revert these changes if they require more than reverting the pull request.

  • If applicable, I've documented the impact of any changes to security controls.

    Examples of changes to security controls include using new access control methods, adding or removing logging pipelines, etc.

If you have any questions, please contact your direct supervisor, GRC (#team-grc), or the PCI working group (#proj-pci-reboot). You can also find more information at PCI Compliance.

@ellieayla
ellieayla requested a review from a team as a code owner August 24, 2026 13:55
The TFE project list api supports filter[i][key/value] query parameters, documented since v1.2.x and working since at least v202507-1.

Expose tag filter via new field in ProjectListOptions, and serialize it to query parameters in Projects.list().
@hashicorp-cla-app

hashicorp-cla-app Bot commented Aug 24, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@ellieayla

Copy link
Copy Markdown
Author

What else is needed on this PR?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants