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

# Update a location

`PATCH /v1/locations/{locationId}`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/locations/{locationId}`
- Auth: HTTP bearer

Update one location. Send only the fields to change; the response is the updated location.

Requires an `Idempotency-Key` header.

## Path parameters

- `locationId` string, uuid, required

## Query parameters

- `select` string

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `address_line1` string
  - `address_line2` string
  - `premise` string
  - `thoroughfare` string
  - `sublocality` string
  - `locality` string
  - `administrative_area` string
  - `administrative_area_code` string
  - `postal_code` string
  - `country` string
  - `country_name` string
  - `formatted_address` string
  - `location_type` string
  - `location_notes` string
  - `is_verified` boolean

## Response `200`

The updated location

- object: The updated location
  - `data` object
    - `id` string, uuid
    - `customer_id` string, uuid
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `premise` string, nullable: Building name or number
    - `thoroughfare` string, nullable: Street name
    - `sublocality` string, nullable: Neighborhood or district
    - `locality` string, nullable: City or town
    - `administrative_area` string, nullable: State or province
    - `administrative_area_code` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable: ISO country code
    - `country_name` string, nullable
    - `formatted_address` string, nullable: Full formatted address string
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `location_precision` string, nullable
    - `what3words_address` string, nullable
    - `plus_code` string, nullable
    - `location_type` string, nullable
    - `location_notes` string, nullable
    - `is_verified` boolean, nullable
    - `verified_at` string, date-time, nullable
    - `verified_by_user_id` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `created_by_user_id` string, uuid, nullable
  - `meta` object
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response

---

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