---
title: "Replace Integration Configurations"
method: PUT
path: "/v3/portals/{portalId}/integrations"
tags: ["Portal Integrations"]
---

# Replace Integration Configurations

`PUT /v3/portals/{portalId}/integrations`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/portals/{portalId}/integrations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Replace the portal integration configurations.

## Path parameters

- `portalId` string, uuid, required

## Request body

- PortalIntegrations: Configuration data for Dev Portal integrations
  - `google_tag_manager` GoogleTagManagerIntegration, nullable: Google Tag Manager integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'tracking', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Google Tag Manager integration
      - `id` string, required: The Google Tag Manager container ID
      - `l` string, nullable: Optional dataLayer variable name
      - `preview` string, nullable: Preview environment name
      - `cookies_win` boolean, nullable: Forces GTM cookies to take precedence when true
      - `debug` boolean, nullable: Enables debug mode when true
      - `npa` boolean, nullable: No Personal Advertising - disables advertising features when true
      - `data_layer` string, nullable: Custom dataLayer name (alternative to "l" property)
      - `env_name` string, nullable: Environment name for environment-specific container
      - `auth_referrer_policy` string, nullable: Referrer policy for analytics requests
  - `google_analytics_4` GoogleAnalytics4Integration, nullable: Google Analytics integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'analytics', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Google Analytics integration
      - `id` string, required: The Google Analytics measurement ID
      - `l` string, nullable: The datalayer's name you want data to be associated with
  - `equal_web` EqualWebIntegration, nullable: Equalweb integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'accessibility', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Equalweb integration
      - `site_key` string, required: The EqualWeb Site Key
      - `widget_config` object

## Response `200`

The current integration configurations for a portal.

- PortalIntegrations: Configuration data for Dev Portal integrations
  - `google_tag_manager` GoogleTagManagerIntegration, nullable: Google Tag Manager integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'tracking', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Google Tag Manager integration
      - `id` string, required: The Google Tag Manager container ID
      - `l` string, nullable: Optional dataLayer variable name
      - `preview` string, nullable: Preview environment name
      - `cookies_win` boolean, nullable: Forces GTM cookies to take precedence when true
      - `debug` boolean, nullable: Enables debug mode when true
      - `npa` boolean, nullable: No Personal Advertising - disables advertising features when true
      - `data_layer` string, nullable: Custom dataLayer name (alternative to "l" property)
      - `env_name` string, nullable: Environment name for environment-specific container
      - `auth_referrer_policy` string, nullable: Referrer policy for analytics requests
  - `google_analytics_4` GoogleAnalytics4Integration, nullable: Google Analytics integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'analytics', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Google Analytics integration
      - `id` string, required: The Google Analytics measurement ID
      - `l` string, nullable: The datalayer's name you want data to be associated with
  - `equal_web` EqualWebIntegration, nullable: Equalweb integration configuration
    - `enabled` boolean, required: Whether the integration is enabled
    - `type` 'accessibility', required: The type of the integration for categorization
    - `config_data` object, required: Configuration data for the Equalweb integration
      - `site_key` string, required: The EqualWeb Site Key
      - `widget_config` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-25** `68d43091b84d`: 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4`: 3 breaking, 24 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - …23 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/portals/:portalId/integrations/put.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)