# Update Disclosure

To un-/disclose multiple BusinessPartners, the disclosure can be changed in three ways:

1. A complete data source identified by the parameter 'dataSourceId' (deprecated - use Sharing Scopes instead. Still applicable, but can be overwritten by Sharing Scopes)
2. Or for a certain country of a data source. This requires both parameters 'dataSourceId' and 'countryCode' to be set (deprecated - use Sharing Scopes instead. Still applicable, but can be overwritten by Sharing Scopes)
3. Or a list of Business Partners, identified by their ID. The other parameters should be left empty. Note: disclosure set via Business Partner ID can be overwritten by creation or deletion of a Sharing Scope.

Any other combination may result in a Bad Request.

For more details, you can read about Sharing Scopes.


Endpoint: POST /v3/storages/{storageId}/businesspartners/updateDisclosure
Version: 5
Security: apiKey

## Path parameters:

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

## Request fields (application/json):

  - `disclosed` (boolean, required)
    Parameter to describe if the BusinessPartners should be disclosed (true) or undisclosed (false).
    Example: "true"

  - `businessPartnerIds` (array)
    List of BusinessPartner IDs to identify all those BusinessPartners that should be un-/disclose.
    Example: ["63e635235c06b7396330fe40"]

  - `dataSourceId` (string)
    A DataSource ID for which all related BusinessPartners should be un-/disclose.
    Example: "648824a691d8d2503d65103e"

  - `countryCode` (string)
    A country code (ISO 3166-2), to be used in combination with a DataSource ID to un-/disclose all matching BusinessPartners.
    Example: "DE"