> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a location

> Update the name and/or address of an existing work location.

Use this endpoint when a work location has been renamed or its address details
have changed.

### Parameters

<ParamField type="string" path="id" initialValue="loc_cNqYX2J3s9bI2Aa" required>
  The ID of the location to update.
</ParamField>

<ParamField type="string" body="name">
  New display name for the location.
</ParamField>

<ParamField type="object" body="address">
  Address fields to update. Plane merges the provided fields onto the existing
  address.

  <Expandable title="child attributes">
    <ParamField type="string" body="address.line1">
      Address line1 (e.g. street, PO Box, or company name).
    </ParamField>

    <ParamField type="string" body="address.line2">
      Address line2 (e.g. apartment, suite, unit or building). Pass `null` to clear it.
    </ParamField>

    <ParamField type="string" body="address.city">
      City, district, suburb, town, or village.
    </ParamField>

    <ParamField type="string" body="address.state">
      State, county, province, or region.
    </ParamField>

    <ParamField type="string" body="address.postal_code">
      ZIP or postal code.
    </ParamField>

    <ParamField type="string" body="address.country">
      Two-letter country code (ISO 3166-1 alpha-2).
    </ParamField>
  </Expandable>
</ParamField>

### Returns

Returns the updated [Location object](/reference/locations/object).

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "loc_cNqYX2J3s9bI2Aa",
    "name": "SF Headquarters",
    "address": {
      "line1": "123 Main Street",
      "line2": null,
      "city": "Oakland",
      "state": "CA",
      "postal_code": "94612",
      "country": "US"
    },
    "created": "2024-01-15T00:00:00Z",
    "updated": "2024-02-10T00:00:00Z"
  }
  ```
</ResponseExample>