# Update an existing city

Updates an existing city within the Property Management System (PMS) with the provided details. Cities help in organizing properties, defining operational zones, and generating location-based insights. This endpoint is useful for modifying existing citys to reflect changes in geographical areas or operational zones. The request body should contain the updated details for the city. If the specified city ID does not exist, a  error will be returned. In case of an unexpected system error, a  will be triggered.

Endpoint: PUT /api/v3/cities/{id}
Version: 3.0.4
Security: OAuth2

## Path parameters:

  - `id` (integer, required)

## Request fields (application/json):

  - `id` (integer)
    City ID
    Example: 1

  - `name` (string)
    City name
    Example: "Birmingham"

  - `region` (object)
    Region details

  - `region.id` (integer)
    Region ID
    Example: 1

  - `region.name` (string)
    Region name
    Example: "West Midlands"

## Response 200 fields (application/json):

  - `id` (integer)
    City ID
    Example: 1

  - `name` (string)
    City name
    Example: "Birmingham"

  - `region` (object)
    Region details

  - `region.id` (integer)
    Region ID
    Example: 1

  - `region.name` (string)
    Region name
    Example: "West Midlands"