From b6d2b1a6a695bd4c0a51360fef9b3819b27dafe9 Mon Sep 17 00:00:00 2001 From: kodjomiles Date: Wed, 12 Nov 2025 13:40:44 +0000 Subject: [PATCH 1/2] Update Terraform Cloud API token documentation to specify required permissions and token types --- .../sync-data-to-catalog/terraform-cloud/terraform-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md b/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md index 670d583665..edbb7517dd 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md @@ -178,7 +178,7 @@ This table summarizes the available parameters for the installation. | `initializePortResources` | When set to true the integration will create default blueprints and the port App config Mapping, defaults is true. | ❌ | | `sendRawDataExamples` | Enable sending raw data examples from the third party API to port for testing and managing the integration mapping, default is true. | ❌ | | `integration.config.terraformCloudHost` | Your Terraform host. For example `https://app.terraform.io` | ✅ | -| `integration.config.terraformCloudToken` | The Terraform cloud API token, docs can be found [here](https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens) | ✅ | +| `integration.config.terraformCloudToken` | Terraform Cloud `API token` with read permissions for organizations, projects, workspaces, runs, and state versions, a `User token` with default read scopes or a `Team token` with read access to those resources is required. Docs can be found [here](https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens) | ✅ |
From 119fce558efb1a76816e4585bedbe762b849060b Mon Sep 17 00:00:00 2001 From: kodjomiles Date: Thu, 13 Nov 2025 12:46:42 +0000 Subject: [PATCH 2/2] Refine Terraform Cloud API token documentation for clarity on token types and permissions --- .../sync-data-to-catalog/terraform-cloud/terraform-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md b/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md index edbb7517dd..cff5100e2a 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/terraform-cloud/terraform-cloud.md @@ -178,7 +178,7 @@ This table summarizes the available parameters for the installation. | `initializePortResources` | When set to true the integration will create default blueprints and the port App config Mapping, defaults is true. | ❌ | | `sendRawDataExamples` | Enable sending raw data examples from the third party API to port for testing and managing the integration mapping, default is true. | ❌ | | `integration.config.terraformCloudHost` | Your Terraform host. For example `https://app.terraform.io` | ✅ | -| `integration.config.terraformCloudToken` | Terraform Cloud `API token` with read permissions for organizations, projects, workspaces, runs, and state versions, a `User token` with default read scopes or a `Team token` with read access to those resources is required. Docs can be found [here](https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens) | ✅ | +| `integration.config.terraformCloudToken` | Terraform Cloud API token with read permissions for organizations, projects, workspaces, runs, and state versions. Provide any one of the following tokens: user API token (default read scopes), team API token (read access to those resources), or organization API token (equivalent read permissions). Docs can be found [here](https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens) | ✅ |