---
title: "Update information on a location."
method: POST
path: "/api/v4/locations/update"
tags: ["Locations"]
---

# Update information on a location.

`POST /api/v4/locations/update`

Updates writable fields on an existing location. Only the fields you send are changed.

## Request body

- object
  - `input` UpdateLocationInput, required
    - `clientMutationId` string
    - `id` string, required
    - `name` string
    - `street` string
    - `city` string
    - `stateIso` string
    - `postalCode` string
    - `countryIso` string
    - `phone` string
    - `businessHours` BusinessHoursDayInput[]
      - `day` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
      - `slots` BusinessHoursSlotInput[]
        - `start` string, required
        - `end` string, required
      - `type` 'OPEN' | 'CLOSED', required
    - `moreHours` MoreHourInput[]
      - `type` string, required
      - `days` MoreHourDayInput[]
        - `day` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
        - `openTime` string
        - `closeTime` string
    - `serviceArea` ServiceAreaInput
      - `businessType` string
      - `regionCode` string
      - `placeInfos` PlaceInfoInput[]
        - `placeId` string, required
        - `placeName` string
    - `customAttributes` CustomAttributeInputType[]
      - `name` string, required
      - `value` string
      - `type` 'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'ENUM' | 'URL'
      - `levelType` 'ACCOUNT' | 'LOCATION'
    - `placeActionLinks` PlaceActionLinkInputType[]
      - `placeActionType` 'APPOINTMENT' | 'ONLINE_APPOINTMENT' | 'DINING_RESERVATION' | 'FOOD_ORDERING' | 'FOOD_DELIVERY' | 'FOOD_TAKEOUT' | 'SHOP_ONLINE', required — Google place action types.
      - `uri` string, required
      - `isPreferred` boolean
      - `name` string
      - `providerType` string
      - `isEditable` boolean
      - `action` string

## Response `200`

Successful response

- UpdateLocationPayload
  - `clientMutationId` string
  - `location` LocationSummaryType — Summary view of a business location.
    - `id` string, required
    - `databaseId` integer
    - `storeId` string
    - `name` string, required
    - `street` string
    - `city` string
    - `stateIso` string
    - `countryIso` string
    - `postalCode` string
    - `latitude` number, float
    - `longitude` number, float
    - `phone` string
    - `website` string
    - `status` 'ACTIVE' | 'ARCHIVED' | 'PENDING' | 'TEMPORARILY_CLOSED' | 'SCHEDULED_FOR_ARCHIVE' — Lifecycle states of a location.
    - `primaryGbpSiteCategoryId` string
    - `additionalGbpSiteCategoryIds` string[]
    - `serviceArea` ServiceAreaType[]
      - `businessType` string
      - `regionCode` string
      - `placeInfos` PlaceInfoType[]
        - `placeId` string, required
        - `placeName` string
    - `tags` TagType[]
      - `id` string, required
      - `name` string, required
    - `folders` FolderType[]
      - `id` string, required
      - `databaseId` integer
      - `name` string, required
      - `parentId` string
      - `root` boolean
      - `path` string
      - `depth` integer
      - `locationCount` integer
    - `placeActionLinks` PlaceActionLinkType[]
      - `placeActionType` string, required
      - `uri` string, required
      - `isPreferred` boolean
      - `name` string
      - `providerType` string
      - `isEditable` boolean
      - `submissionStatus` string
      - `submissionMessage` string
      - `submissionCode` string
      - `lastSubmittedAt` string
    - `discoveredPlaceActionLinks` PlaceActionLinkType[]
      - `placeActionType` string, required
      - `uri` string, required
      - `isPreferred` boolean
      - `name` string
      - `providerType` string
      - `isEditable` boolean
      - `submissionStatus` string
      - `submissionMessage` string
      - `submissionCode` string
      - `lastSubmittedAt` string
  - `errors` MutationErrorType[]
    - `code` string
    - `message` string, required
    - `path` string[]
  - `success` boolean

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error

---

[API](https://skmtc.net/listingsapi/apis/listings-api.md) · [All operations](https://skmtc.net/listingsapi/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/listingsapi/listings-api/revisions/9274a1eac380/schema)