---
title: "Update a Location"
method: POST
path: "/v1/terminal/locations/{location}"
---

# Update a Location

`POST /v1/terminal/locations/{location}`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/terminal/locations/{location}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Updates a `Location` object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

## Path parameters

- `location` string, required

## Response `200`

Successful response.

- union
  - TerminalLocation: A Location represents a grouping of readers. Related guide: [Fleet management](https://docs.stripe.com/terminal/fleet/locations)
    - `address` AddressApiResourceTerminal, required
      - `city` string, nullable: City, district, suburb, town, or village.
      - `country` string, nullable: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `line1` string, nullable: Address line 1, such as the street, PO Box, or company name.
      - `line2` string, nullable: Address line 2, such as the apartment, suite, unit, or building.
      - `postal_code` string, nullable: ZIP or postal code.
      - `state` string, nullable: State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
    - `address_kana` LegalEntityJapanAddress
      - `city` string, nullable: City/Ward.
      - `country` string, nullable: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `line1` string, nullable: Block/Building number.
      - `line2` string, nullable: Building details.
      - `postal_code` string, nullable: ZIP or postal code.
      - `state` string, nullable: Prefecture.
      - `town` string, nullable: Town/cho-me.
    - `address_kanji` LegalEntityJapanAddress
      - `city` string, nullable: City/Ward.
      - `country` string, nullable: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `line1` string, nullable: Block/Building number.
      - `line2` string, nullable: Building details.
      - `postal_code` string, nullable: ZIP or postal code.
      - `state` string, nullable: Prefecture.
      - `town` string, nullable: Town/cho-me.
    - `configuration_overrides` string: The ID of a configuration that will be used to customize all readers in this location.
    - `display_name` string, required: The display name of the location.
    - `display_name_kana` string: The Kana variation of the display name of the location.
    - `display_name_kanji` string: The Kanji variation of the display name of the location.
    - `id` string, required: Unique identifier for the object.
    - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `metadata` object, required: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
    - `object` 'terminal.location', required: String representing the object's type. Objects of the same type share the same value.
    - `phone` string: The phone number of the location.
  - DeletedTerminalLocation
    - `deleted` true, required: Always true for a deleted object
    - `id` string, required: Unique identifier for the object.
    - `object` 'terminal.location', required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)