---
title: "Update Location"
method: PUT
path: "/setup/v1/locations/{id}"
tags: ["Locations"]
---

# Update Location

`PUT /setup/v1/locations/{id}`

Use this endpoint to **Update** a business location object. A valid business **location id** is required. The optional removeRegion query parameter can be used to remove the region relationship from the location.

If the settings element is populated the scope will be set to the business location with the settings supplied. If your settings are uniform across all locations, then do not supply the settings element and the location will use the settings defined on the primary business location (company scoped). Company scoped settings cascade down to the locations. You can override any location that needs different settings by providing settings in the update model. Use the _PUT /setup/v1/locations/{id}/settings/scope/{settingsScope}_ endpoint to change the settings scope only. This is typically used when switching from business location scope back to company.

Refer to: _**POST ​/setup​/v1​/locations**_ endpoint for details.

## Path parameters

- `id` string, required

## Query parameters

- `removeRegion` boolean

## Request body

- LocationUpdateModel
  - `name` string, nullable
  - `adminEmail` string, nullable
  - `adminName` string, nullable
  - `timezoneName` string, nullable
  - `friendlyId` string, nullable
  - `phone` string, nullable
  - `fax` string, nullable
  - `website` string, nullable
  - `email` string, nullable
  - `regionId` string, nullable
  - `address` AddressUpdateModel
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `country` string, nullable
    - `postalCode` string, nullable
  - `businessHours` BusinessHoursUpdateModel
    - `mon` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `tue` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `wed` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `thu` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `fri` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `sat` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
    - `sun` BusinessHourInputModel
      - `startTime` integer — startTime is entered in military format. e.g. 0 = midnight start, 900 = 9am start
      - `endTime` integer — endTime is entered in military format. e.g. 1800 = 6pm end, 2400 = midnight end of day. For 24 hours enter startTime = 0 and endTime = 2400
      - `isOpen` boolean — If false, then not available entire day, starTime and endTime must both be zero. If true, then available between startTime and endTime.
      - `is24Hours` boolean — If true then available for 24 hours. startTime must be zero and endTime must be 2400.
  - `settings` OnlineSettingsUpdateModel
    - `bookAheadUnit` integer, nullable
    - `bookAheadValue` integer, nullable
    - `bookInAdvance` integer, nullable
    - `customerBookingsPerDay` integer, nullable
    - `enableWorldTimezones` boolean, nullable
    - `bookingTimerMins` integer, nullable
  - `defaults` BusinessDefaultsUpdateModel
    - `enableUtcTimezone` boolean, nullable
    - `customerState` boolean, nullable
    - `customerCity` boolean, nullable
    - `autoUpdateCustomer` boolean, nullable
    - `businessNotification` boolean, nullable
    - `emailInfo` boolean, nullable
  - `appointmentReminders` AppointmentRemindersInputModel
    - `emailFirstReminder` integer, nullable
    - `emailFirstReminderInterval` integer
    - `emailSecondReminder` integer, nullable
    - `emailSecondReminderInterval` integer
    - `smsFirstReminder` integer, nullable
    - `smsFirstReminderInterval` integer
    - `smsSecondReminder` integer, nullable
    - `smsSecondReminderInterval` integer

## Response `200`

Success

- LocationViewModel
  - `object` string, nullable
  - `id` string, nullable
  - `friendlyId` string, nullable
  - `companyId` string, nullable
  - `companyName` string, nullable
  - `name` string, nullable
  - `adminEmail` string, nullable
  - `adminName` string, nullable
  - `phone` string, nullable
  - `fax` string, nullable
  - `email` string, nullable
  - `website` string, nullable
  - `regionId` string, nullable
  - `logo` string, nullable
  - `imageUrl` string, nullable
  - `timezoneId` string, nullable
  - `timezoneIana` string, nullable
  - `timezoneOffset` integer, nullable
  - `primaryBusiness` boolean
  - `primaryCalendarId` string, nullable
  - `latitude` number, double
  - `longitude` number, double
  - `travel` TravelViewModel
    - `startAddress` string, nullable
    - `startLat` string, nullable
    - `startLon` string, nullable
    - `distance` string, nullable
    - `proximity` string, nullable
    - `units` string, nullable
  - `address` AddressViewModel
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `country` string, nullable
    - `postalCode` string, nullable
  - `businessHours` BusinessHoursViewModel
    - `mon` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `tue` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `wed` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `thu` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `fri` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `sat` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
    - `sun` BusinessHourViewModel
      - `isOpen` boolean
      - `startTime` integer
      - `endTime` integer
      - `is24Hours` boolean
  - `businessHolidays` BusinessHolidayViewModel[], nullable
    - `id` string, nullable
    - `holidayName` string, nullable
    - `businessClosed` boolean
    - `publicHolidayId` integer
  - `services` BusinessServiceViewModel[], nullable
    - `object` string, nullable
    - `id` integer
    - `serviceId` integer
    - `serviceName` string, nullable
  - `settings` OnlineSettingsViewModel
    - `object` string, nullable
    - `companyId` string, nullable
    - `businessId` string, nullable
    - `locationId` string, nullable
    - `enabled` boolean
    - `familyMembersEnabled` boolean
    - `customerVerification` boolean
    - `serviceLabel` string, nullable
    - `resourceSelection` boolean
    - `resourceLabel` string, nullable
    - `resourceAnyLabel` string, nullable
    - `id` integer
    - `defaultService` boolean, nullable
    - `liveMode` boolean, nullable
    - `firstAvailable` boolean, nullable
    - `formFlow` integer
    - `availabilityForm` integer
    - `showServiceGroups` boolean
    - `bookWithAccount` boolean
    - `bookingPolicy` string, nullable
    - `bookingMessage` string, nullable
    - `showOnSchedLogo` boolean
    - `showBusinessLogo` boolean
    - `enableWorldTimezones` boolean, nullable
    - `disableAuthorization` boolean, nullable
    - `hideNavBar` boolean, nullable
    - `hideLocationNav` boolean, nullable
    - `hideServiceGroupsNav` boolean, nullable
    - `hideServicesNav` boolean, nullable
    - `hideContinueBooking` boolean, nullable
    - `defaultToCustomerTimezone` boolean
    - `returnToService` boolean
    - `returnToAvailability` boolean
    - `hideBreadCrumbNav` boolean
    - `bookingTimerMins` integer
    - `bookAheadUnit` integer
    - `bookAheadValue` integer
    - `bookInAdvance` integer
    - `customerBookingsPerDay` integer
    - `lateCancelHours` integer
    - `lateCancelAction` integer
    - `lateRescheduleHours` integer
    - `lateRescheduleAction` integer
    - `bookingConfirmationMessage` string, nullable
  - `defaults` BusinessDefaultsViewModel
    - `object` string, nullable
    - `enableUtcTimezone` boolean, nullable
    - `customerState` boolean, nullable
    - `customerCity` boolean, nullable
    - `autoUpdateCustomer` boolean, nullable
    - `businessNotification` boolean, nullable
    - `emailInfo` boolean, nullable
  - `appointmentReminders` AppointmentReminderViewModel
    - `emailFirstReminder` integer
    - `emailFirstReminderInterval` integer
    - `emailSecondReminder` integer
    - `emailSecondReminderInterval` integer
    - `smsFirstReminder` integer
    - `smsFirstReminderInterval` integer
    - `smsSecondReminder` integer
    - `smsSecondReminderInterval` integer

---

[API](https://skmtc.net/onsched/apis/onsched-setup-api.md) · [All operations](https://skmtc.net/onsched/apis/onsched-setup-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onsched/onsched-setup-api/versions/c5c023458a2f/schema)