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

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "set the bakery's pickup hours", and it calls updateLocation.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "appId": "<appId>",
    "locationId": "<locationId>"
  },
  "name": "updateLocation"
}

Arguments

• addressLine1stringoptionalStreet address line 1.
• addressLine2stringoptionalStreet address line 2.
• appIdstringrequiredThe Studio app ID whose location to edit.
• bookingHorizonDaysintegeroptionalHow far ahead this location's pickup calendar opens, in days. Absent = the shop's order-ahead rule (orderAheadDays in setShopRules, 30 days unless the owner set one). Up to 730 (two years) for shops that take far-ahead orders (weddings,…
• citystringoptionalCity.
• clearOrderingClosedUntilbooleanoptionaltrue lifts a temporary ordering pause.
• clearPickupStartsAtMinutebooleanoptionaltrue removes the first-pickup-time floor, so windows open at the location's own hours again.
• countrystringoptional2-letter ISO country code (e.g. US).
• exceptionDatesobject[]optionalClosed date ranges and one-off special hours. Replaces the stored list.
• locationIdstringrequiredThe commerce location ID to edit.
• namestringoptionalNew location name.
• orderingClosedUntilnumberoptionalEpoch ms until which ordering is paused (kitchen slammed / after hours).
• 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 =…
• placementobjectoptionalWhere this location surfaces on the brand's storefront.
• postalCodestringoptionalPostal code.
• regionstringoptionalState / region.
• supportedFulfillmentobjectoptionalWhich fulfillment methods this location offers.
• taxRegionobjectoptionalSales tax for this location, owner-set. Applies to orders fulfilled here; a product carrying its own rate overrides it.
• timezonestringoptionalIANA timezone (e.g. "America/New_York") the hours are local to.
• weeklyAvailabilityobject[]optionalThe full weekly hours grid: REPLACES the stored grid, so pass every open weekday (each weekday at most once).

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

Questions

• What does updateLocation do?

  Edit ONE fulfillment location in place: rename it, set pickup hours (weekly availability: per-weekday slots in minutes-from-midnight LOCAL time, e.g. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use updateLocation from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "set the bakery's pickup hours", and it calls updateLocation.

• Is updateLocation safe to let an AI call?

  updateLocation changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.