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

# Update a location

`PUT /v1/locations/{location_id}`

Update a location.

scope: `companies:write`

## Path parameters

- `location_id` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- object
  - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `phone_number` string
  - `street_1` string
  - `street_2` string, nullable
  - `city` string
  - `state` string
  - `zip` string
  - `country` string
  - `mailing_address` boolean — For a company location, specify if this location is the company's mailing address. A company has a single mailing address, so this designation will override any previous selection.
  - `filing_address` boolean — For a company location, specify if this location is the company's filing address. A company has a single filing address, so this designation will override any previous selection.

## Response `200`

successful

- Location — The representation of an address in Gusto.
  - `uuid` string, required — The UUID of the location object.
  - `version` string — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `company_uuid` string — The UUID for the company to which the location belongs. Only included if the location belongs to a company.
  - `phone_number` string — The phone number for the location. Required for company locations. Optional for employee locations.
  - `street_1` string
  - `street_2` string, nullable
  - `city` string
  - `state` string
  - `zip` string
  - `country` string
  - `mailing_address` boolean — Specifies if the location is the company's mailing address. Only included if the location belongs to a company.
  - `filing_address` boolean — Specifies if the location is the company's filing address. Only included if the location belongs to a company.
  - `created_at` string — Datetime for when location is created
  - `updated_at` string — Datetime for when location is updated
  - `active` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.
  - `inactive` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.

## Other responses

- `404` — Not Found
- `409` — Invalid version param
- `422` — Invalid state

---

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