Update Locations

PUT

https://api.bigcommerce.com/stores/:store_hash/v3/inventory/locations

PUT

/stores/:store_hash/v3/inventory/locations

$ curl -X PUT https://api.bigcommerce.com/stores/store_hash/v3/inventory/locations \
>      -H "Accept: application/json" \
>      -H "X-Auth-Token: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '[
>   {
>     "id": 2,
>     "code": "BIGC-2",
>     "label": "Central store",
>     "description": "Central shop of the world",
>     "managed_by_external_source": false,
>     "type_id": "PHYSICAL",
>     "enabled": true,
>     "operating_hours": {
>       "sunday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "monday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "tuesday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "wednesday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "thursday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "friday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       },
>       "saturday": {
>         "open": false,
>         "opening": "08:00",
>         "closing": "16:00"
>       }
>     },
>     "time_zone": "Etc/UTC",
>     "address": {
>       "country_code": "US",
>       "address1": "5th Ave",
>       "address2": "string",
>       "city": "New York City",
>       "state": "NY",
>       "zip": "12345",
>       "email": "test@example.com",
>       "phone": "800-555-0198",
>       "geo_coordinates": {
>         "latitude": 11,
>         "longitude": 11
>       }
>     },
>     "storefront_visibility": true,
>     "special_hours": [
>       {
>         "label": "Thanksgiving",
>         "date": "2022-09-29",
>         "open": true,
>         "opening": "09:00",
>         "closing": "09:00",
>         "all_day": false,
>         "annual": false
>       }
>     ]
>   }
> ]'

1 {
2   "transaction_id": "string"
3 }

Update existing locations.

Limits

Limit of 50 concurrent requests.
Limit of 100 active locations.

Update existing locations. **Limits** * Limit of 50 concurrent requests. * Limit of 100 active locations.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Store Inventory	read-only	`store_inventory_read_only`
Store Inventory	modify	`store_inventory`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see API Accounts and OAuth Scopes.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Store Inventory | read-only | `store_inventory_read_only` | | Store Inventory | modify | `store_inventory` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts). For more about BigCommerce OAuth scopes, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Path parameters

store_hashstringRequired

Permanent ID of the BigCommerce store.

Request

This endpoint expects a list of objects.

Response

The request has been successfully processed.

transaction_idstring

Unique identifier of performed action.

Errors

422

Unprocessable Entity Error

Authentication

OAuth scopes

Authentication header

Further reading

Path parameters

Headers

Request

Response

Errors

OAuth scopes

Authentication header

Further reading