Release/3.0.0 (#260)

* Feat/portal v3 (#254)

* tests: fix portal v2 tests to use classic resource

* tests: add acceptance tests for portal v3 resources

* tests: fix tests using v2 portals

* OpenAPI changes

* Generated provider and docs

* Update CHANGELOG.md

* OpenAPI changes to fix CGW gcp gateway

* Generated provider and docs

* Add new examples and update existing

* Update CHANGELOG.md

* OpenAPI changes: use v3 endpoints for portal team and auth

* Generated provider and docs

* Add a scenario and fix e2e tests

* Feat: null support with tests (#255)

* tests: Add acceptance tests for nullable properties

* tests: add for opentelemetry plugin

* tests: add tests for popular plugins

* tests: add for request transformer, and proxy cache plugins

* tests: fix misconfigured tests

* tests: clean up portal dir structure

* tests: fix tests which used non-nullable properties

* tests: remove refs to portal v2

* OpenAPI changes

* Generated provider and docs

* Add test for plugin ordering

* tests: fix acceptance tests

* OpenAPI changes to fix plugin false diffs

* Generated provider

* Update CHANGELOG.md

* tests: remove expectNonEmptyPlan

* OpenAPI changes to fix plugin false diffs

* Generated provider and docs

* tests: add CRUD test for canary plugin

---------

Co-authored-by: Michael Heap <m@michaelheap.com>

* Feat: API builder v3 (#256)

* tests: add acceptance tests for v3 api resources

* Update CHANGELOG.md

* Add Examples and Scenario

* tests: fix for API implementation

* OpenAPI changes

* Generated provider and docs

* examples: add attributes to konnect_api

* Bump provider to v3 (#257)

* Update v2->v3 references

* Regenerate provider

* Add Control Plane data source (#258)

* Update openapi.yaml

* Regenerate provider

* Add data source lookup test

* Update CHANGELOG

* Update gateway_control_plane data example

* Portal Data Source (#259)

* Update openapi.yaml

* Regenerate provider

* Add test

* Update CHANGELOG

* Update examples

---------

Co-authored-by: Harsha P Dixit <harsha.dixit@konghq.com>

Author: mheap

.speakeasy/gen.lock

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.0.0
+> Released on 2025/08/??
+
+### BREAKING CHANGES
+* `konnect_portal` resource on v2.x of terraform-provider-konnect no longer works with v3.x. Kindly import into `konnect_portal_classic`
+* `konnect_control_plane_list` data source has been removed. The `konnect_control_plane` data source is now available
+
+### Features
+* New resources `konnect_portal`, `konnect_portal_logo`, `konnect_portal_favicon`, `konnect_portal_custom_domain`, `konnect_portal_snippet`, `konnect_portal_page`, `konnect_portal_customization` for Portal are now supported
+* New data source `konnect_portal` is now supported
+* New resources `konnect_api`, `konnect_api_version`, `konnect_api_implementation`, `konnect_api_document`, `konnect_api_specification`, `konnect_api_publication` for API Builder are now supported
+* Add support for `gcp_vpc_peering_transit_gateway` in `konnect_cloud_gateway_transit_gateway` resource
+
+### Bug Fixes
+* Fields that are nullable can be set to null
+
 ## 2.14.0
 > Released on 2025/08/13
 

CHANGELOG.md

@@ -1,19 +1,19 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "konnect_gateway_control_plane_list Data Source - terraform-provider-konnect"
+page_title: "konnect_gateway_control_plane Data Source - terraform-provider-konnect"
 subcategory: ""
 description: |-
-  GatewayControlPlaneList DataSource
+  GatewayControlPlane DataSource
 ---
 
-# konnect_gateway_control_plane_list (Data Source)
+# konnect_gateway_control_plane (Data Source)
 
-GatewayControlPlaneList DataSource
+GatewayControlPlane DataSource
 
 ## Example Usage
 
 ```terraform
-data "konnect_gateway_control_plane_list" "my_gatewaycontrolplanelist" {
+data "konnect_gateway_control_plane" "my_gatewaycontrolplane" {
   filter = {
     cloud_gateway = true
     cluster_type = {
@@ -30,10 +30,10 @@ data "konnect_gateway_control_plane_list" "my_gatewaycontrolplanelist" {
       neq      = "...my_neq..."
     }
   }
-  labels      = "key:value,existCheck"
-  page_number = 1
-  page_size   = 10
-  sort        = "created_at desc"
+  filter_labels = "key:value,existCheck"
+  page_number   = 1
+  page_size     = 10
+  sort          = "created_at desc"
 }
 ```
 
@@ -43,16 +43,24 @@ data "konnect_gateway_control_plane_list" "my_gatewaycontrolplanelist" {
 ### Optional
 
 - `filter` (Attributes) Filters a collection of control-planes. (see [below for nested schema](#nestedatt--filter))
-- `labels` (String) Filter control planes in the response by associated labels.
+- `filter_labels` (String) Filter control planes in the response by associated labels.
 - `page_number` (Number) Determines which page of the entities to retrieve.
 - `page_size` (Number) The maximum number of items to include per page. The last page of a collection may include fewer items.
 - `sort` (String) Sorts a collection of control-planes. Supported sort attributes are:
   - created_at
 
 ### Read-Only
 
-- `data` (Attributes List) (see [below for nested schema](#nestedatt--data))
-- `meta` (Attributes) returns the pagination information (see [below for nested schema](#nestedatt--meta))
+- `config` (Attributes) CP configuration object for related access endpoints. (see [below for nested schema](#nestedatt--config))
+- `description` (String) The description of the control plane in Konnect.
+- `id` (String) The control plane ID.
+- `labels` (Map of String) Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. 
+
+Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
+- `name` (String) The name of the control plane.
+- `number` (Number)
+- `size` (Number)
+- `total` (Number)
 
 <a id="nestedatt--filter"></a>
 ### Nested Schema for `filter`
@@ -93,55 +101,23 @@ Optional:
 
 
 
-<a id="nestedatt--data"></a>
-### Nested Schema for `data`
-
-Read-Only:
-
-- `config` (Attributes) CP configuration object for related access endpoints. (see [below for nested schema](#nestedatt--data--config))
-- `description` (String) The description of the control plane in Konnect.
-- `id` (String) The control plane ID.
-- `labels` (Map of String) Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. 
-
-Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
-- `name` (String) The name of the control plane.
-
-<a id="nestedatt--data--config"></a>
-### Nested Schema for `data.config`
+<a id="nestedatt--config"></a>
+### Nested Schema for `config`
 
 Read-Only:
 
 - `auth_type` (String) The auth type value of the cluster associated with the Runtime Group.
 - `cloud_gateway` (Boolean) Whether the Control Plane can be used for cloud-gateways.
 - `cluster_type` (String) The ClusterType value of the cluster associated with the Control Plane.
 - `control_plane_endpoint` (String) Control Plane Endpoint.
-- `proxy_urls` (Attributes Set) Array of proxy URLs associated with reaching the data-planes connected to a control-plane. (see [below for nested schema](#nestedatt--data--config--proxy_urls))
+- `proxy_urls` (Attributes Set) Array of proxy URLs associated with reaching the data-planes connected to a control-plane. (see [below for nested schema](#nestedatt--config--proxy_urls))
 - `telemetry_endpoint` (String) Telemetry Endpoint.
 
-<a id="nestedatt--data--config--proxy_urls"></a>
-### Nested Schema for `data.config.proxy_urls`
+<a id="nestedatt--config--proxy_urls"></a>
+### Nested Schema for `config.proxy_urls`
 
 Read-Only:
 
 - `host` (String) Hostname of the proxy URL.
 - `port` (Number) Port of the proxy URL.
 - `protocol` (String) Protocol of the proxy URL.
-
-
-
-
-<a id="nestedatt--meta"></a>
-### Nested Schema for `meta`
-
-Read-Only:
-
-- `page` (Attributes) Contains pagination query parameters and the total number of objects returned. (see [below for nested schema](#nestedatt--meta--page))
-
-<a id="nestedatt--meta--page"></a>
-### Nested Schema for `meta.page`
-
-Read-Only:
-
-- `number` (Number)
-- `size` (Number)
-- `total` (Number)

…ta-sources/gateway_control_plane_list.md …cs/data-sources/gateway_control_plane.mddocs/data-sources/gateway_control_plane_list.md renamed to docs/data-sources/gateway_control_plane.md docs/data-sources/gateway_control_plane_list.md renamed to docs/data-sources/gateway_control_plane.md

@@ -0,0 +1,232 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "konnect_portal Data Source - terraform-provider-konnect"
+subcategory: ""
+description: |-
+  Portal DataSource
+---
+
+# konnect_portal (Data Source)
+
+Portal DataSource
+
+## Example Usage
+
+```terraform
+data "konnect_portal" "my_portal" {
+  filter = {
+    authentication_enabled    = true
+    auto_approve_applications = true
+    auto_approve_developers   = true
+    canonical_domain = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    default_api_visibility = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    default_application_auth_strategy_id = {
+      eq  = "...my_eq..."
+      neq = "...my_neq..."
+      oeq = "...my_oeq..."
+    }
+    default_domain = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    default_page_visibility = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    description = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    id = {
+      eq  = "...my_eq..."
+      neq = "...my_neq..."
+      oeq = "...my_oeq..."
+    }
+    name = {
+      contains  = "...my_contains..."
+      eq        = "...my_eq..."
+      neq       = "...my_neq..."
+      ocontains = "...my_ocontains..."
+      oeq       = "...my_oeq..."
+    }
+    rbac_enabled = true
+  }
+  page_number = 1
+  page_size   = 10
+  sort        = "...my_sort..."
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `filter` (Attributes) Filter portals returned in the response. (see [below for nested schema](#nestedatt--filter))
+- `page_number` (Number) Determines which page of the entities to retrieve.
+- `page_size` (Number) The maximum number of items to include per page. The last page of a collection may include fewer items.
+- `sort` (String) Sorts a collection of portals. Supported sort attributes are:
+  - name
+  - description
+  - authentication_enabled
+  - rbac_enabled
+  - auto_approve_applications
+  - auto_approve_developers
+  - default_domain
+  - canonical_domain
+  - created_at
+  - updated_at
+
+### Read-Only
+
+- `authentication_enabled` (Boolean) Whether the portal supports developer authentication. If disabled, developers cannot register for accounts or create applications.
+- `auto_approve_applications` (Boolean) Whether requests from applications to register for APIs will be automatically approved, or if they will be set to pending until approved by an admin.
+- `auto_approve_developers` (Boolean) Whether developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
+- `canonical_domain` (String) The canonical domain of the developer portal
+- `created_at` (String) An ISO-8601 timestamp representation of entity creation date.
+- `default_api_visibility` (String) The default visibility of APIs in the portal. If set to `public`, newly published APIs are visible to unauthenticated developers. If set to `private`, newly published APIs are hidden from unauthenticated developers.
+- `default_application_auth_strategy_id` (String) The default authentication strategy for APIs published to the portal. Newly published APIs will use this authentication strategy unless overridden during publication. If set to `null`, API publications will not use an authentication strategy unless set during publication.
+- `default_domain` (String) The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
+- `default_page_visibility` (String) The default visibility of pages in the portal. If set to `public`, newly created pages are visible to unauthenticated developers. If set to `private`, newly created pages are hidden from unauthenticated developers.
+- `description` (String) A description of the portal.
+- `display_name` (String) The display name of the portal. This value will be the portal's `name` in Portal API.
+- `id` (String) Contains a unique identifier used for this resource.
+- `labels` (Map of String) Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. 
+
+Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
+- `name` (String) The name of the portal, used to distinguish it from other portals. Name must be unique.
+- `number` (Number)
+- `rbac_enabled` (Boolean) Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for APIs until unless assigned to teams with access to view and consume specific APIs. Authentication must be enabled to use RBAC.
+- `size` (Number)
+- `total` (Number)
+- `updated_at` (String) An ISO-8601 timestamp representation of entity update date.
+
+<a id="nestedatt--filter"></a>
+### Nested Schema for `filter`
+
+Optional:
+
+- `authentication_enabled` (Boolean) Filter by a boolean value (true/false).
+- `auto_approve_applications` (Boolean) Filter by a boolean value (true/false).
+- `auto_approve_developers` (Boolean) Filter by a boolean value (true/false).
+- `canonical_domain` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--canonical_domain))
+- `default_api_visibility` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--default_api_visibility))
+- `default_application_auth_strategy_id` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--default_application_auth_strategy_id))
+- `default_domain` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--default_domain))
+- `default_page_visibility` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--default_page_visibility))
+- `description` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--description))
+- `id` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--id))
+- `name` (Attributes) Filters on the given string field value by exact match inequality. (see [below for nested schema](#nestedatt--filter--name))
+- `rbac_enabled` (Boolean) Filter by a boolean value (true/false).
+
+<a id="nestedatt--filter--canonical_domain"></a>
+### Nested Schema for `filter.canonical_domain`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--default_api_visibility"></a>
+### Nested Schema for `filter.default_api_visibility`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--default_application_auth_strategy_id"></a>
+### Nested Schema for `filter.default_application_auth_strategy_id`
+
+Optional:
+
+- `eq` (String)
+- `neq` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--default_domain"></a>
+### Nested Schema for `filter.default_domain`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--default_page_visibility"></a>
+### Nested Schema for `filter.default_page_visibility`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--description"></a>
+### Nested Schema for `filter.description`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--id"></a>
+### Nested Schema for `filter.id`
+
+Optional:
+
+- `eq` (String)
+- `neq` (String)
+- `oeq` (String)
+
+
+<a id="nestedatt--filter--name"></a>
+### Nested Schema for `filter.name`
+
+Optional:
+
+- `contains` (String)
+- `eq` (String)
+- `neq` (String)
+- `ocontains` (String)
+- `oeq` (String)