> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# UpdateBusinessRegion

# Package: siteProperties

# Namespace: SitePropertiesV4

# Method link: https://dev.wix.com/docs/api-reference/business-management/site-properties/properties/update-business-region.md

## Permission Scopes:
SCOPE.DC-SITEPROP.MANAGE-BUSINESS-REGION: SCOPE.DC-SITEPROP.MANAGE-BUSINESS-REGION

## Introduction

Updates a site's payment currency or time zone.

Specify the fields to update in `fields`. Unspecified fields remain unchanged.
To clear a field, include it in `fields` and omit it from `businessRegion`.

---

## REST API

### Schema

```
 Method: updateBusinessRegion
 Description: Updates a site's payment currency or time zone.  Specify the fields to update in `fields`. Unspecified fields remain unchanged. To clear a field, include it in `fields` and omit it from `businessRegion`.
 URL: https://www.wixapis.com/site-properties/v4/properties/business-region
 Method: POST
 Method parameters:
   param name: businessRegion | type: BusinessRegionData | description: Business region settings for a site.  
        - name: paymentCurrency | type: string | description: Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.  | validation: format CURRENCY
        - name: timeZone | type: string | description: Time zone in IANA time zone database format. For example, `America/New_York`.  | validation: maxLength 30
   param name: fields | type: fields | description: Business region fields to update. Properties not included in `fields` are ignored. Properties included in `fields` but omitted from `businessRegion` are cleared.  Supported properties: `paymentCurrency`, `timeZone`.  
 Return type: UpdateBusinessRegionResponse
  EMPTY-OBJECT {}

 Possible Errors:
   HTTP Code: 401 | Status Code: UNAUTHENTICATED | Application Code: META_SITE_NOT_FOUND | Description: Couldn't find the site.
   HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: PERMISSION_DENIED | Description: The [identity](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities.md) used to call the method doesn't have the required permissions.


```

### Examples

### Update a site's payment currency and time zone
```curl
curl -X POST \
'https://www.wixapis.com/site-properties/v4/properties/business-region' \
-H 'Authorization: <AUTH>' \
-H 'Content-Type: application/json' \
-d '{
  "businessRegion": {
    "paymentCurrency": "EUR",
    "timeZone": "Europe/Paris"
  },
  "fields": {
    "paths": ["paymentCurrency", "timeZone"]
  }
}'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.businessTools.siteProperties.updateBusinessRegion(businessRegion, options)
 Description: Updates a site's payment currency or time zone.  Specify the fields to update in `fields`. Unspecified fields remain unchanged. To clear a field, include it in `fields` and omit it from `businessRegion`.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  businessRegion
 Method parameters: 
   param name: businessRegion | type: BusinessRegionData | description: Business region settings for a site. | required: true 
        - name: paymentCurrency | type: string | description: Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.  | validation: format CURRENCY
        - name: timeZone | type: string | description: Time zone in IANA time zone database format. For example, `America/New_York`.  | validation: maxLength 30
   param name: options | type: UpdateBusinessRegionOptions  none  
        - name: fields | type: array<string> | description: Business region fields to update. Properties not included in `fields` are ignored. Properties included in `fields` but omitted from `businessRegion` are cleared.  Supported properties: `paymentCurrency`, `timeZone`.  
 Return type: PROMISE<UpdateBusinessRegionResponse>
  EMPTY-OBJECT {}

 Possible Errors:
   HTTP Code: 401 | Status Code: UNAUTHENTICATED | Application Code: META_SITE_NOT_FOUND | Description: Couldn't find the site.
   HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: PERMISSION_DENIED | Description: The [identity](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities.md) used to call the method doesn't have the required permissions.


```

### Examples

### Update a site's payment currency and time zone
```javascript
import { siteProperties } from "@wix/business-tools";

async function updateBusinessRegion() {
  await siteProperties.updateBusinessRegion(
    {
      paymentCurrency: "EUR",
      timeZone: "Europe/Paris",
    },
    {
      fields: ["paymentCurrency", "timeZone"],
    },
  );
}

/* Promise resolves to void */

```

### updateBusinessRegion (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { siteProperties } from '@wix/business-tools';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { siteProperties },
  // Include the auth strategy and host as relevant
});


async function updateBusinessRegion(businessRegion,options) {
  const response = await myWixClient.siteProperties.updateBusinessRegion(businessRegion,options);
};
```

---