[feat][gov] Update repo to reflect v.2.9.0 of the API (#52)

* update repo to reflect v.2.9.0 of the api

* fixes to cursor slop

* notes in readme

* all tests passing, working on a local server with real examples

* docs

* lint fixes

* add comment on folder deletion recursion

* notes on reviewing

* better handling for config variables as secret

* update docs

* lint

* lint

Author: simplyluke

CONTRIBUTING.md

@@ -66,3 +66,13 @@ New version should show up on Terraform Repository in 10-15 minutes.
 # Update Retool CLI
 Retool CLI has a `terraform` command that generates Terraform configuration from existing Retool org: https://github.com/tryretool/retool-cli/blob/master/src/commands/terraform.ts. 
 If you added a new resource or updated an existing one, you should update Retool CLI as well, so that your changes are reflected in auto-generated configuration.
+
+# Reviewing
+
+Reviewing PRs to this repo can be a challenge, particularly when they impact the OpenAPI generated code for the SDK. 
+
+As a general rule, code within `internal/provider/sdk` will be generated, and can largely be ignored during reviews. 
+
+Code _outside_ of this should be given close attention. `internal/provider` code is what drives the terraform behavior, and should be reviewed for correctness and backward compatibility. Tests should accompany new features, and reviewers should make a habit of checking out PR branches and running them against realisitic example retool deployments.
+
+Updates should always include documentation updates for new/changed behaviors.

docs/data-sources/folders.md

@@ -30,7 +30,7 @@ output "all_folders" {
 
 Read-Only:
 
-- `folder_type` (String) The type of the folder: (app|file|resource|workflow).
+- `folder_type` (String) The type of the folder: (app|file|resource|workflow|agent).
 - `id` (String) The id of the folder.
 - `is_system_folder` (Boolean) Whether the folder is a system folder.
 - `legacy_id` (String) The legacy id of the folder.

docs/data-sources/groups.md

@@ -30,13 +30,15 @@ output "all_groups" {
 
 Read-Only:
 
+- `account_details_access` (Boolean) Whether the group has access to account details.
 - `audit_log_access` (Boolean) Whether the group has audit log access.
 - `created_at` (String) The date the group was created.
 - `id` (String) The id of the group.
 - `landing_page_app_id` (String) The id of the landing page app for the group.
 - `legacy_id` (String) The legacy id of the group.
 - `members` (Attributes List) The members of the group. (see [below for nested schema](#nestedatt--groups--members))
 - `name` (String) The name of the group.
+- `theme_access` (Boolean) Whether the group has access to edit themes.
 - `universal_app_access` (String) The universal app access level of the group.
 - `universal_query_library_access` (String) The universal query library access level of the group.
 - `universal_resource_access` (String) The universal resource access level of the group.

docs/resources/configuration_variable.md

@@ -12,46 +12,46 @@ Manages a Retool configuration variable. Configuration variables are used to sto
 
 ```terraform
 resource "retool_configuration_variable" "test_config_var" {
-  name = "Test Space"
-  value = [
+  name = "Test Config Var"
+  values = [
     {
-      environment_id = "production"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
       value          = "value1"
     },
     {
-      environment_id = "staging"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
       value          = "value2"
     }
   ]
 }
 
-resource "retool_configuration_variable" "test_config_var_with_descritpion" {
-  name        = "Test Space with creation options"
+resource "retool_configuration_variable" "test_config_var_with_description" {
+  name        = "Test Config Var with description"
   description = "This is a test configuration variable with a description"
-  value = [
+  values = [
     {
-      environment_id = "production"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
       value          = "value1"
     },
     {
-      environment_id = "staging"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
       value          = "value2"
     }
   ]
 }
 
 resource "retool_configuration_variable" "test_config_var_as_secret" {
-  name        = "Test Space with creation options"
-  description = "This is a test configuration variable with a description"
+  name        = "Test Secret Config Var"
+  description = "This is a secret configuration variable"
   secret      = true
-  value = [
+  values = [
     {
-      environment_id = "production"
-      value          = "value1"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
+      value          = "secret_value1"
     },
     {
-      environment_id = "staging"
-      value          = "value2"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
+      value          = "secret_value2"
     }
   ]
 }
@@ -68,18 +68,18 @@ resource "retool_configuration_variable" "test_config_var_as_secret" {
 ### Optional
 
 - `description` (String) A brief description of the configuration variable's purpose.
+- `secret` (Boolean) Whether the configuration variable is a secret. Secrets are encrypted and not exposed in the Retool UI.
 
 ### Read-Only
 
 - `id` (String) The unique identifier for the configuration variable.
-- `secret` (Boolean) Whether the configuration variable is a secret. Secrets are encrypted and not exposed in the Retool UI. Secert is currently not supported as the values are encrypted and cannot be retrieved via the API.
 
 <a id="nestedatt--values"></a>
 ### Nested Schema for `values`
 
 Required:
 
 - `environment_id` (String) The ID of the environment this value is associated with.
-- `value` (String) The value of the configuration variable for the specified environment.
+- `value` (String, Sensitive) The value of the configuration variable for the specified environment.
 
 

docs/resources/folder.md

@@ -26,14 +26,24 @@ resource "retool_folder" "resource_example" {
   name        = "Terraform Example Folder"
   folder_type = "resource"
 }
+
+resource "retool_folder" "workflow_example" {
+  name        = "Terraform Workflow Folder"
+  folder_type = "workflow"
+}
+
+resource "retool_folder" "agent_example" {
+  name        = "Terraform Agent Folder"
+  folder_type = "agent"
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
 ### Required
 
-- `folder_type` (String) The type of the folder: (app|resource|workflow).
+- `folder_type` (String) The type of the folder: (app|resource|workflow|agent).
 - `name` (String) The name of the folder.
 
 ### Optional

docs/resources/group.md

@@ -22,6 +22,7 @@ resource "retool_group" "example" {
   audit_log_access           = true
   unpublished_release_access = false
   usage_analytics_access     = true
+  theme_access               = false
   account_details_access     = true
   landing_page_app_id        = "c37676ba-116f-11ea-b17d-d7734e1526f2"
 }
@@ -39,6 +40,7 @@ resource "retool_group" "example" {
 - `account_details_access` (Boolean) Whether the group has access to account details.
 - `audit_log_access` (Boolean) Whether the group has access to the audit log.
 - `landing_page_app_id` (String) The app ID of the landing page.
+- `theme_access` (Boolean) Whether the group has access to edit themes.
 - `universal_app_access` (String) The universal app access level for the group. This denotes the access level that this group has for all apps. Accepted values: none|use|edit|own
 - `universal_query_library_access` (String) Level of access that the group has to the Query Library. Accepted values: none|use|edit
 - `universal_resource_access` (String) The universal resource access level for the group. This denotes the access level that this group has for all resources. Accepted values: none|use|edit|own

docs/resources/source_control_settings.md

@@ -16,6 +16,7 @@ resource "retool_source_control_settings" "scm_settings" {
   custom_pull_request_template_enabled = true
   custom_pull_request_template         = "custom-pull-request-template"
   version_control_locked               = true
+  auto_cleanup_branches_enabled        = false
   force_uuid_mapping                   = false
 }
 ```
@@ -26,6 +27,7 @@ resource "retool_source_control_settings" "scm_settings" {
 ### Optional
 
 - `auto_branch_naming_enabled` (Boolean) When enabled, Retool automatically suggests a branch name on branch creation. Defaults to true.
+- `auto_cleanup_branches_enabled` (Boolean) When enabled, Retool automatically cleans up branches after they are merged. Defaults to false.
 - `custom_pull_request_template` (String) Pull requests created from Retool will use the template specified.
 - `custom_pull_request_template_enabled` (Boolean) When enabled, Retool will use the template specified to create pull requests. Defaults to false.
 - `force_uuid_mapping` (Boolean) When set to true, creates a uuid mapping for protected elements to be used in the source control repo. Defaults to false.

examples/resources/retool_configuration_variable/resource.tf

@@ -1,44 +1,44 @@
 resource "retool_configuration_variable" "test_config_var" {
-  name = "Test Space"
-  value = [
+  name = "Test Config Var"
+  values = [
     {
-      environment_id = "production"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
       value          = "value1"
     },
     {
-      environment_id = "staging"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
       value          = "value2"
     }
   ]
 }
 
-resource "retool_configuration_variable" "test_config_var_with_descritpion" {
-  name        = "Test Space with creation options"
+resource "retool_configuration_variable" "test_config_var_with_description" {
+  name        = "Test Config Var with description"
   description = "This is a test configuration variable with a description"
-  value = [
+  values = [
     {
-      environment_id = "production"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
       value          = "value1"
     },
     {
-      environment_id = "staging"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
       value          = "value2"
     }
   ]
 }
 
 resource "retool_configuration_variable" "test_config_var_as_secret" {
-  name        = "Test Space with creation options"
-  description = "This is a test configuration variable with a description"
+  name        = "Test Secret Config Var"
+  description = "This is a secret configuration variable"
   secret      = true
-  value = [
+  values = [
     {
-      environment_id = "production"
-      value          = "value1"
+      environment_id = "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" # prod
+      value          = "secret_value1"
     },
     {
-      environment_id = "staging"
-      value          = "value2"
+      environment_id = "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" # staging
+      value          = "secret_value2"
     }
   ]
 }

examples/resources/retool_folder/resource.tf

@@ -13,3 +13,13 @@ resource "retool_folder" "resource_example" {
   name        = "Terraform Example Folder"
   folder_type = "resource"
 }
+
+resource "retool_folder" "workflow_example" {
+  name        = "Terraform Workflow Folder"
+  folder_type = "workflow"
+}
+
+resource "retool_folder" "agent_example" {
+  name        = "Terraform Agent Folder"
+  folder_type = "agent"
+}

examples/resources/retool_group/resource.tf

@@ -7,6 +7,7 @@ resource "retool_group" "example" {
   audit_log_access           = true
   unpublished_release_access = false
   usage_analytics_access     = true
+  theme_access               = false
   account_details_access     = true
   landing_page_app_id        = "c37676ba-116f-11ea-b17d-d7734e1526f2"
 }