---
title: "Update a location"
method: POST
path: "/v1/location/{location_id}"
tags: ["Locations"]
---

# Update a location

`POST /v1/location/{location_id}`

## Path parameters

- `location_id` string, required

## Request body

- UpdateLocationRequest
  - `custom_fields` object, nullable — Partial update of custom fields. Only specified fields will be updated.
  - `reference_key` string, nullable
  - `market_id` string, nullable — ID of the market this location belongs to. Must reference an existing market in your organization.

## Response `200`

OK

- LocationResponse
  - `location` LocationExternalSchema, required
    - `id` string, required
    - `address_1` string, required
    - `address_2` string, nullable, required
    - `city` string, required
    - `state` string, required
    - `zip_code` string, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `reference_key` string, nullable, required — Optional unique identifier for this location in your system.
    - `market_id` string, nullable, required — ID of the market this location belongs to.
    - `market_name` string, nullable, required — Deprecated: prefer market_id. Name of the geographic market this location belongs to.
    - `custom_fields` object, nullable, required — Arbitrary key-value metadata. Supports partial updates.

---

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