1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. updateLocation

Commerce

updateLocation

Update Location

Edit ONE fulfillment location in place: rename it, set pickup hours (weekly availability: per-weekday slots in minutes-from-midnight LOCAL time, e.g.

write

Arguments

• appIdstringrequiredThe Studio app ID whose location to edit.
• locationIdstringrequiredThe commerce location ID to edit.
• namestringoptionalNew location name.
• timezonestringoptionalIANA timezone (e.g. "America/New_York") the hours are local to.
• addressLine1stringoptionalStreet address line 1.
• addressLine2stringoptionalStreet address line 2.
• citystringoptionalCity.
• regionstringoptionalState / region.
• postalCodestringoptionalPostal code.
• countrystringoptional2-letter ISO country code (e.g. US).
• placementobjectoptionalWhere this location surfaces on the brand's storefront.
• supportedFulfillmentobjectoptionalWhich fulfillment methods this location offers.
• weeklyAvailabilityobject[]optionalThe full weekly hours grid: REPLACES the stored grid, so pass every open weekday (each weekday at most once).
• exceptionDatesobject[]optionalHoliday closures / one-off special hours: REPLACES the stored list.
• orderingClosedUntilnumberoptionalEpoch ms until which ordering is paused (kitchen slammed / after hours).
• clearOrderingClosedUntilbooleanoptionaltrue lifts a temporary ordering pause.
• bookingHorizonDaysintegeroptionalHow far ahead this location's pickup calendar opens, in days: the shop's order-ahead window. Absent = the platform default (30). Up to 730 (two years) for shops that take far-ahead orders (weddings, events).
• pickupStartsAtMinuteintegeroptionalThe first pickup time customers may choose, in minutes from midnight LOCAL to the location's timezone (510 = 8:30am), independent of opening hours. Windows that end at or before it are removed; a window straddling it opens at it. Absent =…
• clearPickupStartsAtMinutebooleanoptionaltrue removes the first-pickup-time floor, so windows open at the location's own hours again.
• taxRegionobjectoptionalSales tax for this location, owner-set. Applies to orders fulfilled here; a product carrying its own rate overrides it.

Returns

The registry does not declare a return shape.

Declared limits

• bookingHorizonDays: minimum 1
• bookingHorizonDays: maximum 730
• pickupStartsAtMinute: minimum 0
• pickupStartsAtMinute: maximum 1439

Ask for it

The Cloud routes these requests to this verb.

• set the bakery's pickup hours
• rename The Hub
• first pickup at 8:30 even though we open at 7
• let customers order months ahead
• close ordering until Monday
• add a holiday closure

Pair it with

The verbs that finish the job.

• createLocation
• listLocations