---
title: "Update the Gateway feature configuration"
method: PUT
path: "/gatewayConfiguration"
tags: ["Gateway Configuration"]
---

# Update the Gateway feature configuration

`PUT /gatewayConfiguration`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gatewayConfiguration`
- Auth: none declared

Updates the Gateway configuration including feature settings.

## Request body

- object
  - `config` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfig
    - `default` string, nullable: Default gateway cluster ID
    - `features` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfigFeatures, required: Feature-specific configurations
      - `integrations` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfigFeaturesIntegrations, required: Integration feature configuration for gateway routing
        - `overrideGlobalCluster` boolean, required: Whether to override the global cluster configuration for integrations
        - `cluster` string, nullable: The cluster ID to use for integrations when overriding global
        - `executionMode` 'direct' | 'proxy' | 'cluster_no_proxy', required: The execution mode for integrations
        - `proxy` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfigFeaturesIntegrationsProxy: Proxy configuration for integrations
          - `host` string, required: Proxy host address
          - `port` string, required: Proxy port number
          - `auth` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfigFeaturesIntegrationsProxyAuth: Proxy authentication credentials
            - `authMode` 'none' | 'basic' | 'secrets_manager', required: Authentication mode for the proxy
            - `username` string: Proxy authentication username
            - `password` string: Proxy authentication password (will be encrypted if authMode is basic)
      - `runCode` GatewayConfigurationPutRequestBodyContentApplicationJsonSchemaConfigFeaturesRunCode, required: Run Code Task feature configuration for gateway routing
        - `defaultCluster` string, nullable, required: Cluster ID used automatically when a Run Code Task does not specify a cluster, or when its assigned cluster is no longer allowed. Null for no default.
        - `allowedClusters` string[], required: Additional cluster IDs builders may select for a Run Code Task, beyond the default cluster

## Response `200`

The result of the configuration update operation.

- GatewayConfigurationUpdateGatewayConfigurationResponse200
  - `state` 'Success' | 'Error', required: Status of the operation
  - `message` string, required: Message describing the result of the operation
  - `data` GatewayConfigurationPutResponsesContentApplicationJsonSchemaData, required: Additional data about the update operation
    - `modifiedCount` integer: Number of documents modified (should be 1 on success)

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Configuration` added
  - api tag `gatewayConfiguration` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gatewayConfiguration/put.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)