---
title: "Update location"
method: PUT
path: "/v1/locations/{location}"
tags: ["Location"]
---

# Update location

`PUT /v1/locations/{location}`

Update an existing location's address fields. All fields are required.

## Path parameters

- `location` string, uuid, required

## Headers

- `X-BUSINESS-API-KEY` string, required

## Request body

- object
  - `name` string, required
  - `street` string, required
  - `city` string, required
  - `state` string, required
  - `country` string, required
  - `postal_code` string, required

## Response `200`

Location updated successfully

- object
  - `id` string, uuid, required — Location ID
  - `business_id` string, uuid, required — Business that owns this location
  - `name` string, required — Name of the location
  - `street` string, required — Street address
  - `city` string, required — City
  - `state` string, required — State or region
  - `country` string, required — Country code or name
  - `postal_code` string, required — Postal code
  - `active` boolean, required — Whether the location is active
  - `pickups` object[] — Pickup configurations linked to this location (empty when not loaded)
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Missing or invalid API key / OAuth token
- `403` — Authenticated user cannot manage locations
- `404` — Location not found or does not belong to this business
- `422` — Validation error

---

[API](https://skmtc.net/hitpayapp/apis/hitpay-api.md) · [All operations](https://skmtc.net/hitpayapp/apis/hitpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hitpayapp/hitpay-api/versions/6aae1a736990/schema)