---
title: "Update a location"
method: PATCH
path: "/v1/public/locations/{locationId}"
tags: ["Public", "Locations"]
---

# Update a location

`PATCH /v1/public/locations/{locationId}`

## Path parameters

- `locationId` string, required

## Request body

- UpdatePublicLocationRequest
  - `name` string — the name of the location
  - `code` string — A human readable ID that can be use has an ID for other API calls. The code is also used to map a location to an external system structural element.
  - `externalId` string — A unique UID or a human readable ID that can be use has an ID for other API calls. The externalId can also be used to map a location to an external system structural element.
  - `abbrev` string — an abbreviation text, used in various place in the application where space is tight. Like on shifts of the schedule view.
  - `address` string — the full address of the location
  - `radiusInM` number — a radius in meter around the location center point where a punch entry is considered valid
  - `geoLocationEnabled` boolean — when true a punch is valid if the location of the user is within the location coordinates and radius
  - `latitude` number — the latitude coordinate of the location
  - `longitude` number — the longitude coordinate of the location
  - `custom` object — To set custom fields to a location. You can pass a json objet where the values are string. Will merge with previous values.

## Response `200`

- PublicLocation
  - `uid` string, required — unique location id
  - `status` 'deleted' | 'active', required — Location status
  - `name` string, required — Location name
  - `abbrev` string — Location abbreviation
  - `code` string — The location code. The code is often used as a mapping value between Evolia and an external system
  - `externalId` string — The unique location externalId. The externalId is often used as a mapping value between Evolia and an external system
  - `address` string — Location address
  - `coordinates` string[] — 0: Longitude, 1: Latitude
  - `subLocationIds` string[] — Array of sub location UIDs linked to the location
  - `subLocations` string[] — Array of sub locations
  - `custom` object, nullable — An optional object of custom properties. Current implementation only support string values

---

[API](https://skmtc.dev/evolia/apis/public-evolia.md) · [All operations](https://skmtc.dev/evolia/apis/public-evolia/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolia/public-evolia/revisions/91b80f2b4802/schema)