# Toggle Business Partners Update Monitoring

To toggle update monitoring on multiple BusinessPartners, the permission can be changed
via a list of Business Partners, identified by their ID.

After the job is finished, the following actions are taken for Business Partners which match the businessPartnerIds criteria:
* businessPartner.updateMonitoring fields takes a value of ToggleUpdateMonitoringJobRequest#enable
* if enable is true then:
  * an attempt is taken to find Business Partner in all configured update monitors for non-commercial reference data sources and links are created if matches are found via defined linkage strategies
  * if the storage has UPDATES feature activated, updates for linked Business Partners from non-commercial reference data sources are propagated to Business Partner updates
* if enable is false then:
  * all existing links of a Business Partner to Business Partners in non-commercial reference data sources are removed
  * updates are no more propagated for this Business Partner
  * linkage is not performed for any non-commercial reference data source

For toggling a complete Data Source or for a certain Country of a Data Source,
please go to Start Toggle Update Monitoring Job.


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

## Path parameters:

  - `storageId` (string, required)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

## Request fields (application/json):

  - `enable` (boolean, required)
    Parameter to describe if the Business Partners should be activated for update monitoring (true) or deactivated (false) for non-commercial reference data sources.
    Example: "true"

  - `businessPartnerIds` (array, required)
    List of Business Partner IDs to identify all those Business Partners that should be activated/deactivated.
    Example: ["63e635235c06b7396330fe40"]