---
title: "Update a property (Beta)"
method: PATCH
path: "/properties/{property_id}"
tags: ["Properties"]
---

# Update a property (Beta)

`PATCH /properties/{property_id}`

Updates an existing property in your EasyBroker account. This endpoint is still in beta, please contact our support team if you have any problem or want to share any feedback.

## Request body

- PropertyBody
  - `property_type` string, required — The name of the property type. You can get the full list of property types from the `property_types` endpoint.
  - `title` string, required — The property listing title.
  - `description` string, required — The property listing description.
  - `status` 'published' | 'sold' | 'rented' | 'reserved' | 'suspended' | 'not_published', required — The property status
  - `private_description` string — A private description visible only to your team.
  - `operations` PropertyOperationBody[], required
    - union
      - PropertyOperationSaleOrRentalBody
        - `type` 'sale' | 'rental', required
        - `active` boolean, required — Indicates whether this operation is active or not.
        - `amount` number, double, required
        - `currency` string, required
        - `unit` 'total' | 'square_meter' | 'hectare' — Indicates the property price unit. Defaults to "total"
        - `commission` PropertyCommissionBody
          - `type` 'amount' | 'percentage' | 'months' — The month type is only available for rental commission.
          - `value` number — Commission value corresponding to the specified type. For commission type "months", valid values are: 0.5, 1, 1.5, 2, 3, 4, 5.
          - `currency` string — Only applicable for the "amount" type.
        - `foreclosure` boolean — Indicates whether the property is up for auction. This option is available only to agencies in Mexico.
      - PropertyOperationTemporaryRentalBody
        - `type` string, required
        - `active` boolean, required — Indicates whether this operation is active or not.
        - `currency` string, required
        - `rates` TemporaryRentalRateBody[], required
          - `type` 'daily' | 'weekly' | 'monthly', required
          - `amount` number, double, required
  - `agent` string — The EasyBroker account email of the agent assigned to the property.
  - `show_prices` boolean — An option that allows you to show or hide the EB listing prices.
  - `bedrooms` integer — The number of bedrooms.
  - `bathrooms` integer — The number of bathrooms.
  - `half_bathrooms` integer — The number of half bathrooms.
  - `parking_spaces` integer — The number of parking spaces.
  - `age` string — One of "under_construction", "new_construction" or the year the property was built.
  - `floor` string — The floor number in which the property is located, useful for apartments. It can be set to a custom value such as 'Penthouse'
  - `floors` integer — The number of floors in the building.
  - `expenses` string — The monthly expenses of the property.
  - `internal_id` string — A unique id used in your organization. It can only contain letters, numbers and a small set of special characters (- _ , . & /)
  - `location` PropertyLocationBody, required
    - `name` string — A location string containing the neighborhood, city and the administrative division where the property is located. It must match a location found through the locations endpoint.
    - `street` string — The street where the property is located. Required if the property type isn't in the land category and show exact location is true.
    - `exterior_number` string — The property address exterior number.
    - `interior_number` string — The property address interior number.
    - `cross_street` string — The property address cross street.
    - `postal_code` string — The property address postal code.
    - `latitude` number — The latitude where the property is located.
    - `longitude` number — The longitude where the property is located.
  - `tags` string[] — An array of strings, each one is a tag that will be associated with the property.
  - `features` string[] — An array with the names of all the features for this property. You can get the full list of features from the features endpoint.
  - `share_commission` boolean — An option to specify whether your agency is willing to share the commission with other agencies in the EasyBroker agency network.
  - `collaboration_notes` string — Notes on conditions or details for collaborations.
  - `images` PropertyImageBody[] — An array of objects, each one containing an image url and a title. Note: Images are processed asynchronously and might take some time to appear in your listing. For an existing listing, this array replaces the existing images. Image requirements: URL must be a valid HTTP/HTTPS URL with file extension (.jpg, .png, .gif, .bmp, .heic), maximum 6MB per image, minimum 500px width or height, valid image MIME type, up to 50 images per listing.
    - `title` string
    - `url` string, required
  - `videos` string[] — An array of strings, each one is a youtube video link that will be associated with the property.
  - `virtual_tour` string — A link to a virtual tour of the property.
  - `show_exact_location` boolean — Set it to 'true' to show the exact address location and map location or 'false' to hide it.
  - `construction_size` number — In square meters
  - `lot_size` number — In square meters
  - `lot_length` integer — In meters
  - `lot_width` integer — In meters
  - `covered_space` number — In square meters. Not Available in Mexico.
  - `uncovered_space` number — In square meters. Only available in Mexico and Argentina.
  - `exclusive` boolean, nullable — Indicates whether the listing is exclusive. Set to `null` if not specified.
  - `shared_commission_percentage` number, nullable — Indicates the percentage of the agency fee that is shared. At the moment, it can only be set to 50% or `null` if not specified.

## Response `200`

The property was updated successfully

- PropertySingle
  - `public_id` string
  - `title` string
  - `foreclosure` boolean — Indicates whether the property is up for auction. This option is available only to agencies in Mexico.
  - `property_images` PropertyImage[] — Note: Images are processed asynchronously and might take some time to appear in your listing. Deprecated, you should use the "images" attribute instead.
    - `url` string
    - `title` string
  - `images` PropertyImage[] — Note: Images are processed asynchronously and might take some time to appear in your listing.
    - `url` string
    - `title` string
  - `description` string
  - `bedrooms` integer
  - `bathrooms` integer
  - `half_bathrooms` integer
  - `parking_spaces` integer
  - `lot_size` number — In square meters
  - `construction_size` number — In square meters
  - `lot_length` integer
  - `lot_width` integer
  - `covered_space` number — In square meters. Not Available in Mexico.
  - `uncovered_space` number — In square meters. Only available in Mexico and Argentina.
  - `floors` integer
  - `floor` integer
  - `age` string — One of "under_construction", "new" or the year the building was built
  - `internal_id` string — A user defined property ID
  - `expenses` string
  - `property_type` string
  - `agent` Agent
    - `id` integer
    - `name` string
    - `full_name` string
    - `mobile_phone` string
    - `profile_image_url` string
    - `email` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `published_at` string, date-time
  - `features` PropertyFeature[]
    - `name` string
    - `category` string
  - `public_url` string
  - `collaboration_notes` string
  - `property_files` string[]
  - `videos` string[]
  - `virtual_tour` string
  - `exclusive` boolean, nullable — Indicates whether the listing is exclusive. Set to `null` if not specified.
  - `shared_commission_percentage` number, nullable — Indicates the percentage of the agency fee that is shared. At the moment, it can only contain 50% or `null` if not specified.
  - `private_description` string
  - `location` PropertyLocation
    - `name` string, required
    - `latitude` number
    - `longitude` number
    - `street` string
    - `postal_code` string
    - `show_exact_location` boolean, required
    - `exterior_number` string — The property address exterior number.
    - `interior_number` string — The property address interior number.
  - `tags` string[]
  - `show_prices` boolean
  - `share_commission` boolean
  - `operations` PropertyOperationWithCommission[]
    - union
      - PropertyOperationSaleOrRentalWithCommission
        - `type` 'sale' | 'rental'
        - `amount` number, double
        - `formatted_amount` string
        - `currency` string
        - `unit` 'total' | 'square_meter' | 'hectare' — Some properties, like warehouses, are sold and rented per square meter. Some terrains are rented per hectare.
        - `commission` PropertyCommission
          - `type` 'percentage' | 'months' | 'amount' — Months type only applies for rental operation.
          - `value` number, double
          - `currency` string
      - PropertyOperationTemporaryRental
        - `type` string, required
        - `amount` number, double
        - `formatted_amount` string
        - `currency` string, required
        - `period` 'monthly' | 'weekly' | 'daily' — Used for temporary rentals

## Other responses

- `401` — API key is missing or invalid, or a restricted country was selected
- `404` — No property was found with the provided ID
- `422` — The property couldn't be updated because it is invalid

---

[API](https://skmtc.dev/easybroker/apis/easybroker-api.md) · [All operations](https://skmtc.dev/easybroker/apis/easybroker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/easybroker/easybroker-api/revisions/1aea2ecce635/schema)