---
title: "Update Location"
method: PUT
path: "/v2/tms-api/locations/{external_reference_id}"
tags: ["TMS API", "TMS API - Locations"]
---

# Update Location

`PUT /v2/tms-api/locations/{external_reference_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms-api/locations/{external_reference_id}`
- Auth: none declared

Update an existing location.

## Path parameters

- `external_reference_id` string, required

## Headers

- `X-API-Key` string, nullable: API key for authentication

## Request body

- LocationUpdate: Schema for updating a location. All fields are optional.
  - `name` string, nullable: Location name
  - `address_line1` string, nullable: Street address line 1
  - `address_line2` string, nullable: Street address line 2
  - `city` string, nullable: City
  - `state` string, nullable: State/Province
  - `postal_code` string, nullable: Postal/ZIP code
  - `country` string, nullable: Country
  - `latitude` number, nullable: Latitude
  - `longitude` number, nullable: Longitude
  - `iana_timezone` string, nullable: IANA timezone for the facility (e.g., 'America/Chicago').
  - `email` string, nullable: Contact email
  - `phone_number` string, nullable: Contact phone number
  - `weekday_open_hours` string, nullable: Weekday opening hours (HH:MM)
  - `weekday_close_hours` string, nullable: Weekday closing hours (HH:MM)
  - `weekend_open_hours` string, nullable: Weekend opening hours (HH:MM)
  - `weekend_close_hours` string, nullable: Weekend closing hours (HH:MM)
  - `internal_notes` string, nullable: Internal notes

## Response `200`

Successful Response

- LocationResponse: Response schema for a location.
  - `id` string, required: Internal Mentium ID
  - `external_reference_id` string, required: External reference ID from your system
  - `name` string, nullable: Location name
  - `address_line1` string, nullable: Street address line 1
  - `address_line2` string, nullable: Street address line 2
  - `city` string, nullable: City
  - `state` string, nullable: State/Province
  - `postal_code` string, nullable: Postal/ZIP code
  - `country` string, nullable: Country
  - `latitude` number, nullable: Latitude
  - `longitude` number, nullable: Longitude
  - `iana_timezone` string, nullable: IANA timezone for the facility (e.g., 'America/Chicago'). Used to render stop times in the facility's local TZ.
  - `email` string, nullable: Contact email
  - `phone_number` string, nullable: Contact phone number
  - `weekday_open_hours` string, nullable: Weekday opening hours
  - `weekday_close_hours` string, nullable: Weekday closing hours
  - `weekend_open_hours` string, nullable: Weekend opening hours
  - `weekend_close_hours` string, nullable: Weekend closing hours
  - `internal_notes` string, nullable: Internal notes
  - `created_at` string, date-time, required: Creation timestamp
  - `updated_at` string, date-time, required: Last update timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)