Update a property

patch

https://api.easybroker.com/v1/properties/{property_id}

Updates an existing property in your EasyBroker account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

property_id

string

required

The public or internal ID of the specified property

Body Params

property_type

string

required

The property type symbol returned by the property_types endpoint. Names remain accepted for backward compatibility.

title

string

required

The property listing title.

description

string

required

The property listing description.

status

string

enum

required

The property status

Allowed:

private_description

string

A private description visible only to your team.

operations

array of objects

required

operations*

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

One of "under_construction", "new_construction" or the year the property was built. The year may be sent as an integer or a four-digit string.

conservation_state

string | null

enum

The condition of the property. Send null to leave it unspecified. Not available for building, commercial or land property types; the value is ignored for those.

Allowed:

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.

rental_maintenance_included

boolean | null

Indicates whether monthly maintenance is included in the rental price. Required when rental is active and maintenance_amount is provided; otherwise it is cleared to null when rental is inactive.

maintenance_amount

integer | null

1 to 2147483647

Monthly maintenance amount. When rental is active, rental_maintenance_included must be specified; the amount is required when that field is false.

maintenance_currency

string

Currency code for the maintenance amount. Defaults to the operation currency (rental, sale or temporary rental, in that order) when omitted.

internal_id

string

A unique id used in your organization. It can only contain letters, numbers and a small set of special characters (- _ , . & /)

location

object

required

tags

features

array of strings

An array with the names of all the features for this property. You can get the full list of features from the features endpoint.

features

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

array of objects

An array of objects, each one containing an image url and a title. Images are processed asynchronously and might take some time to appear in your listing. The API does not expose processing status; retrieve the property again and check its images array. For an existing listing, this array replaces the existing images. Image requirements: URL must be a valid HTTP/HTTPS URL with file extension (.jpg, .jpeg, .png, .gif, .heic, .webp), maximum 6MB per image, minimum 500px width or height, valid image MIME type, up to 50 images per listing.

images

videos

array of strings

An array of strings, each one is a youtube video link that will be associated with the property.

videos

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

number

In meters

lot_width

number

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 | null

Indicates whether the listing is exclusive. Set to null if not specified.

shared_commission_percentage

number | null

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.

Responses

200The property was updated successfully

401API key is missing or invalid

404No property was found with the provided ID

422The property couldn't be updated because it is invalid