# Update Configuration

Allows users to update their configuration for their organization.

Endpoint: PUT /configurations/businesspartnercuration/{configurationId}
Version: 3
Security: apiKey

## Path parameters:

  - `configurationId` (string, required)
    ID of the configuration.
    Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"

## Request fields (application/json):

  - `name` (string)
    The name of the configuration.
    Example: "My configuration"

  - `configuration` (object)
    Allows users to configure Data Curation settings.

  - `configuration.contextConfigurations` (array)
    List of Context Configurations.

  - `configuration.contextConfigurations.context` (object)
    is used for applying configuration for specific country.  is used only for presentation purposes.

  - `configuration.contextConfigurations.context.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `configuration.contextConfigurations.context.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `configuration.contextConfigurations.context.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `configuration.contextConfigurations.addressCurationLevelThreshold` (string)
    Defines threshold for address found in external source like HERE above which it is consider as good. Range 0..1.
    Example: "0.5"

  - `configuration.contextConfigurations.outputLanguageTechnicalKey` (string)
    ISO 639-1 two-letter code of languages.
    Example: "DE"

  - `configuration.contextConfigurations.outputCharsets` (array)
    List of Output Charsets.

  - `configuration.contextConfigurations.outputCharsets.concept` (string)
    Defines concept for output charset.
    Example: "ADDRESS"

  - `configuration.contextConfigurations.outputCharsets.charset` (string)
    Defines type for output charset.
    Example: "LATIN"

  - `configuration.contextConfigurations.profile` (string)
    Used to configure the curation process.
    Example: "STANDARD"

  - `configuration.contextConfigurations.featuresOn` (array)
    Example: ["ENRICH_ADDRESS"]

  - `configuration.contextConfigurations.featuresOff` (array)
    Example: ["ENRICH_ADDRESS"]

  - `configuration.contextConfigurations.addressDataSources` (object)
    Preferred data sources for curation. Default PrimaryAddressDataSource is HERE. Default SecondaryAddressDataSource is CDQ.

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource` (object)
    Data source for curation.

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource.technicalKey` (string)
    Technical key for Address Data Source.
    Example: "HERE"

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource.threshold` (number)
    Threshold for the address data source. The threshold is a value between 0.0 and 1.0.
    Example: "0.4"

  - `configuration.contextConfigurations.addressDataSources.secondaryAddressDataSources` (array)

  - `configuration.contextConfigurations.numberSeparator` (object)
    Number separator for features , .

  - `configuration.contextConfigurations.numberSeparator.value` (string)
    Number separator value for features.
    Example: ","

  - `configuration.contextConfigurations.inputAddressConceptsIgnored` (array)
    A list of technical keys of concepts. Selected concepts will be ignored during curation process. 
This feature is mainly used in configurations, if i.e. for certain countries selected inputs 
should be ignored without changing the current technical integration. 
Please note that ignored concepts will be taken over to the curation result without any change.
    Enum: "BUILDING", "CITY", "COUNTY", "DISTRICT", "LEVEL", "POST_CODE", "REGION", "ROOM", "THOROUGHFARE_NUMBER"

  - `configuration.goldenRecordSettings` (object)
    Golden Record settings for a specific configuration.

  - `configuration.goldenRecordSettings.dataSources` (array, required)

  - `configuration.goldenRecordSettings.dataSources.countryScope` (object, required)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `configuration.goldenRecordSettings.dataSources.primaryDataSource` (object, required)
    Golden Record settings for a single data source.

  - `configuration.goldenRecordSettings.dataSources.primaryDataSource.technicalKey` (string)
    Technical key of the data source.
    Example: "BR_RF"

  - `configuration.goldenRecordSettings.dataSources.secondaryDataSources` (array)

  - `configuration.goldenRecordSettings.dataSources.otherDataSources` (array)

  - `configuration.goldenRecordSettings.dataSources.unallowedDataSources` (array)

## Response 200 fields (application/json):

  - `id` (string)
    Uniquely identifies a configuration.
    Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"

  - `name` (string)
    Display name for a configuration.
    Example: "Client configuration."

  - `version` (integer)
    Version number of the configuration.
    Example: 1

  - `configuration` (object)
    Allows users to configure Data Curation settings.

  - `configuration.contextConfigurations` (array)
    List of Context Configurations.

  - `configuration.contextConfigurations.context` (object)
    is used for applying configuration for specific country.  is used only for presentation purposes.

  - `configuration.contextConfigurations.context.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `configuration.contextConfigurations.context.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `configuration.contextConfigurations.context.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `configuration.contextConfigurations.addressCurationLevelThreshold` (string)
    Defines threshold for address found in external source like HERE above which it is consider as good. Range 0..1.
    Example: "0.5"

  - `configuration.contextConfigurations.outputLanguageTechnicalKey` (string)
    ISO 639-1 two-letter code of languages.
    Example: "DE"

  - `configuration.contextConfigurations.outputCharsets` (array)
    List of Output Charsets.

  - `configuration.contextConfigurations.outputCharsets.concept` (string)
    Defines concept for output charset.
    Example: "ADDRESS"

  - `configuration.contextConfigurations.outputCharsets.charset` (string)
    Defines type for output charset.
    Example: "LATIN"

  - `configuration.contextConfigurations.profile` (string)
    Used to configure the curation process.
    Example: "STANDARD"

  - `configuration.contextConfigurations.featuresOn` (array)
    Example: ["ENRICH_ADDRESS"]

  - `configuration.contextConfigurations.featuresOff` (array)
    Example: ["ENRICH_ADDRESS"]

  - `configuration.contextConfigurations.addressDataSources` (object)
    Preferred data sources for curation. Default PrimaryAddressDataSource is HERE. Default SecondaryAddressDataSource is CDQ.

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource` (object)
    Data source for curation.

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource.technicalKey` (string)
    Technical key for Address Data Source.
    Example: "HERE"

  - `configuration.contextConfigurations.addressDataSources.primaryAddressDataSource.threshold` (number)
    Threshold for the address data source. The threshold is a value between 0.0 and 1.0.
    Example: "0.4"

  - `configuration.contextConfigurations.addressDataSources.secondaryAddressDataSources` (array)

  - `configuration.contextConfigurations.numberSeparator` (object)
    Number separator for features , .

  - `configuration.contextConfigurations.numberSeparator.value` (string)
    Number separator value for features.
    Example: ","

  - `configuration.contextConfigurations.inputAddressConceptsIgnored` (array)
    A list of technical keys of concepts. Selected concepts will be ignored during curation process. 
This feature is mainly used in configurations, if i.e. for certain countries selected inputs 
should be ignored without changing the current technical integration. 
Please note that ignored concepts will be taken over to the curation result without any change.
    Enum: "BUILDING", "CITY", "COUNTY", "DISTRICT", "LEVEL", "POST_CODE", "REGION", "ROOM", "THOROUGHFARE_NUMBER"

  - `configuration.goldenRecordSettings` (object)
    Golden Record settings for a specific configuration.

  - `configuration.goldenRecordSettings.dataSources` (array, required)

  - `configuration.goldenRecordSettings.dataSources.countryScope` (object, required)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `configuration.goldenRecordSettings.dataSources.primaryDataSource` (object, required)
    Golden Record settings for a single data source.

  - `configuration.goldenRecordSettings.dataSources.primaryDataSource.technicalKey` (string)
    Technical key of the data source.
    Example: "BR_RF"

  - `configuration.goldenRecordSettings.dataSources.secondaryDataSources` (array)

  - `configuration.goldenRecordSettings.dataSources.otherDataSources` (array)

  - `configuration.goldenRecordSettings.dataSources.unallowedDataSources` (array)

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-09-12T14:57:38Z"

  - `modifiedAt` (string)
    User or Client UUID which modified the resource.
    Example: "76248934691294444"

  - `createdBy` (string)
    Creator of a resource.
    Example: "76248934691294444"

  - `transactionId` (string)
    ID of the transaction, pass it in subsequent requests to make them part of the transaction.
    Example: "8e37da1e-ee9d-4ee0-b03d-24a1f89988f2"