---
title: "Update estate"
method: PUT
path: "/places/{id}/estates/{estate_id}"
tags: ["Estates"]
---

# Update estate

`PUT /places/{id}/estates/{estate_id}`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/places/{id}/estates/{estate_id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required
- `estate_id` string, uuid, required

## Request body

- UpdateEstate: Data for updating an existing property. **Update behavior for optional fields**: - **Field absent**: the existing value is preserved (no modification) - **Field present with `null`**: the value is removed (set to NULL in database) - **Field present with value**: the value is updated **Fields affected by this behavior**: - `number_of_room`: can be set to `null` to remove the value **Fields assigned directly (can already be set to null)**: - `orientation`, `building`, `floor`, `lot_number`, `housing_tax`, `property_tax`, `acquisition_price`, `construction_date`, `renovation_date`, `address`, `other_detail` **Changing place**: - `place_id`: can be modified to move a property to another place - **Important**: Changing `place_id` is only possible via flat routes `/estates/{id}` (PUT) - Nested routes `/places/{place_id}/estates/{estate_id}` do not allow changing the `place_id` - The new `place_id` must exist and belong to the same tenant, otherwise a 404 error will be returned
  - `name` string, nullable: Property name
  - `place_id` string, uuid, nullable: Identifier of the place to which the property is associated. **Changing place**: - This field can be modified to move a property to another place - Use the flat route `PUT /estates/{id}` to change this field - The new `place_id` must exist and belong to the same tenant - If the new place does not exist or belongs to another tenant, a 404 error will be returned - If this field is absent from the request, the existing value is preserved
  - `estate_type_id` string, uuid, nullable
  - `area` number, nullable
  - `number_of_room` integer, nullable: Number of rooms. **Update behavior**: - Field absent: the existing value is preserved - `null`: the value is removed (set to NULL in database) - Integer: the value is updated
  - `orientation` string, nullable
  - `building` string, nullable
  - `floor` integer, nullable
  - `lot_number` string, nullable
  - `fiscal_identifier` string, nullable: Property tax identifier
  - `housing_tax` number, nullable
  - `property_tax` number, nullable
  - `acquisition_price` number, nullable
  - `rent_amount` number, nullable: Reference rent amount for the property (in euros). **Update behavior**: - Field absent: the existing value is preserved - Field present with `null`: the value is removed (set to NULL) - Field present with value: the value is updated **Note**: Directly modifying this field does not affect existing leases. Active leases retain their rent. This field serves as the default value for future leases.
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable
  - `address` string, nullable
  - `other_detail` string, nullable
  - `rental_status` 'VACANT' | 'RENTED' | 'NOTICE': Rental status of a property. - **VACANT**: Vacant property, no active lease - **RENTED**: Rented property, at least one active lease - **NOTICE**: Property under notice period, at least one lease under notice (without an active lease) This status is automatically synchronized with the status of associated leases when statuses change (ACTIVE, NOTICE, TERMINATED).

## Response `200`

OK

- Estate
  - `id` string, uuid, nullable
  - `name` string, nullable: Property name
  - `place_id` string, uuid, nullable
  - `estate_type_id` string, uuid, nullable
  - `area` number, nullable
  - `number_of_room` integer, nullable
  - `orientation` string, nullable
  - `building` string, nullable
  - `floor` integer, nullable
  - `owner_id` string, uuid, nullable
  - `previous_owner_id` string, uuid, nullable
  - `lot_number` string, nullable
  - `fiscal_identifier` string, nullable: Property tax identifier (required)
  - `housing_tax` number, nullable
  - `property_tax` number, nullable
  - `acquisition_price` number, nullable
  - `rent_amount` number, nullable: Reference rent amount for the property (in euros). Automatically synchronized with active leases.
  - `rental_status` 'VACANT' | 'RENTED' | 'NOTICE': Rental status of a property. - **VACANT**: Vacant property, no active lease - **RENTED**: Rented property, at least one active lease - **NOTICE**: Property under notice period, at least one lease under notice (without an active lease) This status is automatically synchronized with the status of associated leases when statuses change (ACTIVE, NOTICE, TERMINATED).
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable
  - `address` string, nullable
  - `other_detail` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Bad request
- `500`: Bad request

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)