---
title: "Changes to Update an AI Gateway Vault"
method: PUT
path: "/v1/ai-gateways/{gatewayId}/vaults/{vaultIdOrName}"
---

# Changes to Update an AI Gateway Vault

`PUT /v1/ai-gateways/{gatewayId}/vaults/{vaultIdOrName}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
- **2026-09-25** `68d43091b84d`: 3 warning
- **2026-09-18** `f324fb7610e4`: 4 breaking, 30 info
- **2026-08-24** `46dabd88efd3`: 84 warning
- **2026-08-12** `0aee8d012787`: 7 breaking, 7 warning, 14 info
- **2026-08-11** `4fef3868064f`: 34 breaking, 48 info
- **2026-08-07** `0261aef4b1e2`: 7 warning, 7 info
- **2026-07-16** `a2e95e9f6c80`: 1 info

## 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`: 4 breaking, 30 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`
  - the response's body type changed from no type to `object` for status `429`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `429`
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `404` status
  - added the optional property `type` to the response with the `429` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - added the required property `detail` to the response with the `404` status
  - added the required property `detail` to the response with the `429` status
  - added the required property `instance` to the response with the `400` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `instance` to the response with the `404` status
  - added the required property `instance` to the response with the `429` status
  - added the required property `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `404` status
  - added the required property `status` to the response with the `429` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `403` status
  - added the required property `title` to the response with the `404` status
  - added the required property `title` to the response with the `429` status
- **2026-08-24** `46dabd88efd3`: 84 warning
  - the `oneOf[#/components/schemas/AwsSecretsManagerVault]/config/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/AwsSecretsManagerVault]/config/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/AwsSecretsManagerVault]/config/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/AzureKeyVault]/config/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/AzureKeyVault]/config/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/AzureKeyVault]/config/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/ConjurVault]/config/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/ConjurVault]/config/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/ConjurVault]/config/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/GoogleSecretManagerVault]/config/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/GoogleSecretManagerVault]/config/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/GoogleSecretManagerVault]/config/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAppRoleConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAppRoleConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAppRoleConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsEC2Config]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsEC2Config]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsEC2Config]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsIAMConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsIAMConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsIAMConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAzureConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAzureConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAzureConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultCertConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultCertConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultCertConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpGCEConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpGCEConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpGCEConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpIAMConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpIAMConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpIAMConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultKubernetesConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultKubernetesConfig]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultKubernetesConfig]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultOauth2Config]/neg_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultOauth2Config]/resurrect_ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultOauth2Config]/ttl` request property's max was set to `4294967295.00`
  - the `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultTokenConfig]/neg_ttl` request property's max was set to `4294967295.00`
  - …44 more
- **2026-08-12** `0aee8d012787`: 7 breaking, 7 warning, 14 info
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/AwsSecretsManagerVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/AzureKeyVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/ConjurVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/EnvironmentVariableVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/GoogleSecretManagerVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/HashiCorpVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/KonnectConfigStoreVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/AwsSecretsManagerVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/AzureKeyVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/ConjurVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/EnvironmentVariableVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/GoogleSecretManagerVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/HashiCorpVault]/name` request property `allOf` list
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/KonnectConfigStoreVault]/name` request property `allOf` list
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/AwsSecretsManagerVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/AzureKeyVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/ConjurVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/EnvironmentVariableVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/GoogleSecretManagerVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/HashiCorpVault]/name` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AIGatewayVaultName` to the `oneOf[#/components/schemas/KonnectConfigStoreVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/AwsSecretsManagerVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/AzureKeyVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/ConjurVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/EnvironmentVariableVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/GoogleSecretManagerVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/HashiCorpVault]/name` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/AIGatewayEntityIdentifier` from the `oneOf[#/components/schemas/KonnectConfigStoreVault]/name` response property `allOf` list for the response status `200`
- **2026-08-11** `4fef3868064f`: 34 breaking, 48 info
  - the `auth_method` request property const value `approle` was added
  - the `auth_method` request property const value `aws_ec2` was added
  - the `auth_method` request property const value `aws_iam` was added
  - the `auth_method` request property const value `azure` was added
  - the `auth_method` request property const value `cert` was added
  - the `auth_method` request property const value `gcp_gce` was added
  - the `auth_method` request property const value `gcp_iam` was added
  - the `auth_method` request property const value `jwt` was added
  - the `auth_method` request property const value `kubernetes` was added
  - the `auth_method` request property const value `token` was added
  - the `type` request property const value `aws` was added
  - the `type` request property const value `azure` was added
  - the `type` request property const value `conjur` was added
  - the `type` request property const value `env` was added
  - the `type` request property const value `gcp` was added
  - the `type` request property const value `hcv` was added
  - the `type` request property const value `konnect` was added
  - removed the enum value `approle` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAppRoleConfig]/auth_method`
  - removed the enum value `aws` of the request property `oneOf[#/components/schemas/AwsSecretsManagerVault]/type`
  - removed the enum value `aws_ec2` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsEC2Config]/auth_method`
  - removed the enum value `aws_iam` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAwsIAMConfig]/auth_method`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/AzureKeyVault]/type`
  - removed the enum value `azure` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultAzureConfig]/auth_method`
  - removed the enum value `cert` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultCertConfig]/auth_method`
  - removed the enum value `conjur` of the request property `oneOf[#/components/schemas/ConjurVault]/type`
  - removed the enum value `env` of the request property `oneOf[#/components/schemas/EnvironmentVariableVault]/type`
  - removed the enum value `gcp` of the request property `oneOf[#/components/schemas/GoogleSecretManagerVault]/type`
  - removed the enum value `gcp_gce` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpGCEConfig]/auth_method`
  - removed the enum value `gcp_iam` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultGcpIAMConfig]/auth_method`
  - removed the enum value `hcv` of the request property `oneOf[#/components/schemas/HashiCorpVault]/type`
  - removed the enum value `jwt` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultOauth2Config]/auth_method`
  - removed the enum value `konnect` of the request property `oneOf[#/components/schemas/KonnectConfigStoreVault]/type`
  - removed the enum value `kubernetes` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultKubernetesConfig]/auth_method`
  - removed the enum value `token` of the request property `oneOf[#/components/schemas/HashiCorpVault]/config/oneOf[#/components/schemas/HashiCorpVaultTokenConfig]/auth_method`
  - the `description` request property default value `` was added
  - the `description` request property default value `` was added
  - the `description` request property default value `` was added
  - the `description` request property default value `` was added
  - the `description` request property default value `` was added
  - the `description` request property default value `` was added
  - …42 more
- **2026-08-07** `0261aef4b1e2`: 7 warning, 7 info
  - changed the pattern of the request property `oneOf[#/components/schemas/AwsSecretsManagerVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/AzureKeyVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/ConjurVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/EnvironmentVariableVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/GoogleSecretManagerVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/HashiCorpVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[#/components/schemas/KonnectConfigStoreVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - the `oneOf[#/components/schemas/AwsSecretsManagerVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/AzureKeyVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/ConjurVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/EnvironmentVariableVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/GoogleSecretManagerVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/HashiCorpVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
  - the `oneOf[#/components/schemas/KonnectConfigStoreVault]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
- **2026-07-16** `a2e95e9f6c80`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v1/ai-gateways/:gatewayId/vaults/:vaultIdOrName/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-gateways/:gatewayId/vaults/:vaultIdOrName/put)
