From 8504091be168306e3437fb9abb6276bc5348d0ec Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 13 Jul 2026 09:09:53 +0000
Subject: [PATCH] docs: add kosli_control list resource reference page for
 v0.8.1

---
 config/navigation.json                        |  6 ++
 .../list-resources/control.mdx                | 55 +++++++++++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 terraform-reference/list-resources/control.mdx

diff --git a/config/navigation.json b/config/navigation.json
index c45cf0c..d930ae2 100644
--- a/config/navigation.json
+++ b/config/navigation.json
@@ -517,6 +517,12 @@
                 "terraform-reference/data-sources/service_account",
                 "terraform-reference/data-sources/control"
               ]
+            },
+            {
+              "group": "List Resources",
+              "pages": [
+                "terraform-reference/list-resources/control"
+              ]
             }
           ]
         },
diff --git a/terraform-reference/list-resources/control.mdx b/terraform-reference/list-resources/control.mdx
new file mode 100644
index 0000000..3b30b64
--- /dev/null
+++ b/terraform-reference/list-resources/control.mdx
@@ -0,0 +1,55 @@
+---
+title: "kosli_control list resource"
+description: "Lists Kosli controls in the organization for use with terraform query, so existing controls can be discovered and brought under Terraform management without hand-writing one import block per control."
+icon: "list"
+---
+
+Lists Kosli controls in the organization for use with `terraform query` (requires Terraform >= 1.14), so existing controls can be discovered and brought under Terraform management without hand-writing one `import` block per control.
+
+<Warning>
+Controls is a **beta** feature and must be enabled for your organization; API requests return `403 Forbidden` otherwise.
+</Warning>
+
+<Note>
+The Kosli list endpoint does not return `policies_referencing`, so when resource data is included in query results that attribute is always reported as an empty list. Archived controls are only returned when `archived = true` is set.
+</Note>
+
+## Example usage
+
+Place `list` blocks in a `.tfquery.hcl` file and run `terraform query` (requires Terraform >= 1.14):
+
+```terraform
+# List all active controls in the organization
+list "kosli_control" "all" {
+  provider = kosli
+}
+
+# List controls matching a search string, including full resource data
+# (e.g. for `terraform query -generate-config-out=generated.tf`)
+list "kosli_control" "sdlc" {
+  provider         = kosli
+  include_resource = true
+
+  config {
+    search = "SDLC"
+  }
+}
+
+# Include archived controls in the results
+list "kosli_control" "archived" {
+  provider = kosli
+
+  config {
+    archived = true
+  }
+}
+```
+
+Use `terraform query -generate-config-out=generated.tf` to generate `import` blocks and resource configuration for the discovered controls. To manage the resulting controls, see the [`kosli_control` resource](/terraform-reference/resources/control).
+
+## Schema
+
+### Optional
+
+- `archived` (Boolean) Include archived controls in the results. Defaults to `false`.
+- `search` (String) Case-insensitive substring to match against control names and identifiers.