# Update Storage

Update a Business Partner Storage.

Endpoint: PUT /storages/{storageId}
Version: 5
Security: apiKey

## Path parameters:

  - `storageId` (string, required)
    Unique ID of a Business Partner Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

## Request fields (application/json):

  - `name` (string)
    Name of the Business Partner Storage.
    Example: "CDQ AG"

  - `labels` (array)
    List of Storages labels.
    Example: ["Custom Storage Name"]

  - `dataMatchingDefinitionId` (string)
    ID of related data matching definition that is used for matching lookup candidates for internal lookup of this Business Partner Storage.
    Example: "6400955811c68a034bcef311"

  - `sharedWithOrganization` (boolean)
    Indicates if this Business Partner Storage is shared with all users of the same organization
    Example: "true"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `name` (string)
    Name of the Business Partner Storage.
    Example: "CDQ AG"

  - `eventStoreId` (string)
    Internal ID of Event Store.
    Example: "72d6900fce6b326123f5d9d91049e3e6"

  - `decisionLogId` (string)
    ID of related decision log.
    Example: "72d6900fc3wb326088f5d9d91044e3e6"

  - `organization` (string)
    Uniquely identifying ID of the organization.
    Example: "cdq_monitor"

  - `user` (string)
    Unique ID of a user.
    Example: "johndoe"

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-09-10T10:12:36Z"

  - `expiresAt` (string)
    Date when storage expires.

Possible values:
* a date when a storage expires,
* NEVER when storage is a Data Mirror or has been created including NEVER_EXPIRE feature.

Expiry date is calculated based on the date of last write operation related
to a storage (upsert of data, update of data sources, executed job) plus 6 months,
refreshed as most 2 weeks before previous storage expiration date.
    Example: "2025-09-10T10:12:35Z"

  - `dataMatchingDefinitionId` (string)
    ID of related data matching definition that is used for matching lookup candidates for internal lookup of this Business Partner Storage.
    Example: "6400955811c68a034bcef311"

  - `dataSources` (array)
    List of Data Sources.

  - `dataSources.lastUpdatedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-09-10T10:12:36Z"

  - `dataSources.name` (string)
    Name of a data source of a storage.
    Example: "Internal customers"

  - `dataSources.dataMapperDefinitionId` (string)
    ID of related Data Mapper Definition that is used for mapping data of this Business Partner Storage.
    Example: "6440dba32b30176c5917b1b7"

  - `dataSources.dataTransformationDefinitionId` (string)
    Unique identifier for a data transformation definition.
    Example: "SAP.ODM"

  - `dataSources.mappingDisclosure` (boolean)
    Determines whether disclosed field is set via Data Mapper Definition (true) or via Sharing Scopes (false). For more details, you can
read about [Data Mapper Definition](https://developer.cdq.com/reference-docs/data-exchange/V5/tag/Data-Mapping/paths/~1datamapperdefinitions/post/) and [Sharing Scopes](https://developer.cdq.com/reference-docs/data-exchange/V5/tag/Business-Partner-Storages/paths/~1v4~1storages~1%7BstorageId%7D~1sharingscopes/post/)."
    Example: "true"

  - `dataMonitors` (array)
    List of data monitors.

  - `dataMonitors.id` (string)
    Unique alpha-numeric number of the Data Monitor.
    Example: "bfdfd6f7-562f-4d4a-921f-e68cba60d5cf"

  - `dataMonitors.type` (object)
    Type of the Data Monitor.

  - `dataMonitors.type.name` (string)
    Display name of the Data Monitor Type.
    Example: "Augmentation"

  - `dataMonitors.type.technicalKey` (string)
    Technical key of a data monitor.
    Example: "AUGMENTATION"

  - `dataMonitors.enabled` (boolean)
    The toggle used to enable or disable the Data Monitor.
    Example: true

  - `dataMonitors.disabledAt` (string)
    Date in ISO-8601 format when data monitor was disabled.
    Example: "2025-09-10T10:12:36Z"

  - `dataMonitors.configuration` (object)
    Configuration which is used during processing Business Partners.

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

  - `dataMonitors.executions` (array)
    Available executions of data monitor.

  - `dataMonitors.executions.type` (object, required)
    Type of the Data Monitor Execution.

  - `dataMonitors.executions.type.technicalKey` (string, required)
    Technical key of the Data Monitor Execution Type.
    Example: "TRIGGER"

  - `dataMonitors.executions.frequency` (string)
    It is the interval at which updates are performed.
    Example: "BI_WEEKLY"

  - `dataMonitors.validitySpan` (object)
    Period after which Business Partner is evaluated again.

  - `dataMonitors.validitySpan.technicalKey` (string)
    Validity span period.
    Example: "YEAR"

  - `dataMonitors.scopes` (array)
    Scope of data monitor.

  - `dataMonitors.scopes.technicalKey` (string)
    Data Monitor scope of selected products.

Augmentation Data Monitor may be one of:
* AUGMENTED_BUSINESS_PARTNERS - enables Business Partner Augmentation
* RAW_UPDATES - enables Raw Updates
* OVERLAP - enables Overlap

By default, when empty in Augmentation Data Monitor, below are enabled:
* AUGMENTED_BUSINESS_PARTNERS
* RAW_UPDATES
    Example: "RAW_UPDATES"

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

  - `dataMonitors.modifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-09-10T10:12:36Z"

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

  - `dataMonitors.featuresOn` (array)
    Features to be activated for Data Monitor.
    Example: ["BUILD_REPORT"]

  - `features` (object)
    Features of a storage.

  - `features.lookup` (object)
    Status of a feature.

  - `features.lookup.status` (string)
    Status of a feature.
    Enum: "ENABLED", "DISABLED"

  - `features.updates` (object)
    Status of a feature.

  - `features.sharing` (object)
    Status of a feature.

  - `features.neverExpire` (object)
    Status of a feature.

  - `features.tagsManagedByUpsert` (object)
    Status of a feature.

  - `numberOfCountries` (integer)
    Number of countries in the Business Partner Storage.
    Example: "12"

  - `numberOfRecords` (integer)
    Number of records in the Business Partner Storage.
    Example: "500"

  - `countryStatistics` (array)

  - `countryStatistics.countryCode` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `originalFileHeader` (array)
    List of headers used for a modification of metadata.
    Example: ["BusinessPartnerId, Name, Address"]

  - `originalFileName` (string)
    Name of the last file that was used to import data into this Business Partner Storage.
    Example: "business-partner.csv"

  - `results` (object)
    Results of a Business Partner Storage.

  - `results.addressCurationReports` (array)
    List of Address Curation Reports.

  - `results.addressCurationReports.creationTimestamp` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-09-10T10:12:36Z"

  - `results.addressCurationReports.description` (string)
    Description of the Report.
    Example: "Report description"

  - `results.addressCurationReports.name` (string)
    Display Name of the Report.
    Example: "Report name"

  - `results.addressCurationReports.type` (string)
    Type of the Report.
    Example: "Report type"

  - `results.addressCurationReports.url` (string)
    URL of the Report.
    Example: "https://www.cdq.com"

  - `results.goldenRecordGenerationReports` (array)
    List of Golden Record Generation Reports.

  - `results.resultItems` (array)
    List of Result Items.

  - `results.resultItems.country` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `results.resultItems.label` (string)
    Label of the Result Item.
    Example: "Result Item label"

  - `results.resultItems.type` (string)
    Type of the Result Item.
    Example: "Result Item type"

  - `results.validationReports` (array)
    List of Validation Reports.

  - `status` (string)
    Status of a Business Partner Storage.
    Example: "FILE_IMPORTED_SUCCESSFULLY"

  - `statusMessage` (string)
    Details related to status.
    Example: "BusinessPartner batch could not be upserted into Business Partner Storage."

  - `sharedWithOrganization` (boolean)
    Indicates if this Business Partner Storage is shared with all users of the same organization
    Example: "true"

  - `labels` (array)
    Labels to categorize the storage.
    Example: ["Custom Storage Name"]

  - `domain` (string)
    Domain of a Business Partner Storage.
    Example: "BusinessPartner"