---
title: "Update a lease-lessee association"
method: PUT
path: "/leases/{lease_id}/lessees/{lessee_id}"
tags: ["Leases", "Lessees"]
---

# Update a lease-lessee association

`PUT /leases/{lease_id}/lessees/{lessee_id}`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/lessees/{lessee_id}`
- Auth: HTTP bearer

Updates the information of a specific association between a lease and a lessee.

## Path parameters

- `lease_id` string, uuid, required
- `lessee_id` string, uuid, required

## Request body

- UpdateLeaseLessee: Data for updating a lessee-lease association
  - `role_type` 'PRIMARY' | 'CO_TENANT' | 'GUARANTOR': Role of the lessee in the lease
  - `rent_share` number, nullable: Rent share for this lessee (if co-tenancy)
  - `end_date` string, date, nullable: End date of the association
  - `ended_by_amendment_id` string, uuid, nullable: Amendment ID that ended this association
  - `guarantor_max_amount` number, nullable: Maximum guaranteed amount (if role = GUARANTOR)
  - `guarantor_conditions` string, nullable: Specific guarantee conditions
  - `guarantees_lessee_id` string, uuid, nullable: Lessee ID guaranteed by this guarantor (if role = GUARANTOR)

## Response `200`

Lease-lessee association updated successfully

- LeaseLessee: Association of a lessee with a lease
  - `id` string, uuid, required: Unique identifier of the association
  - `lease_id` string, uuid, required: Associated lease ID
  - `lessee_id` string, uuid, required: Associated lessee ID
  - `role_type` 'PRIMARY' | 'CO_TENANT' | 'GUARANTOR', required: Role of the lessee in the lease
  - `rent_share` number, nullable: Rent share for this lessee (if co-tenancy)
  - `start_date` string, date, required: Start date of the association
  - `end_date` string, date, nullable: End date of the association
  - `created_at` string, date-time, required: Creation date
  - `updated_at` string, date-time, required: Last modification date
  - `created_by_amendment_id` string, uuid, nullable: Amendment ID that created this association
  - `ended_by_amendment_id` string, uuid, nullable: Amendment ID that ended this association
  - `guarantor_max_amount` number, nullable: Maximum guaranteed amount (if role = GUARANTOR)
  - `guarantor_conditions` string, nullable: Specific guarantee conditions
  - `guarantees_lessee_id` string, uuid, nullable: Lessee ID guaranteed by this guarantor (if role = GUARANTOR)
  - `guarantor_engagement_type` 'SIMPLE' | 'SOLIDAIRE', nullable: Nature of the surety's undertaking (if role = GUARANTOR). A guarantor with no `guarantor_max_amount` **and** no `guarantor_engagement_type` cannot be committed: the surety deed cannot be drawn up, and the signature pre-flight will report a `caution_incomplete` blocker. Any value other than `SIMPLE` or `SOLIDAIRE` is rejected: it is never silently treated as "unset".
  - `electronic_delivery_consent` boolean, required: Whether this tenant has consented to receiving documents: rent receipts in particular: by email (ALUR §6). Consent is per tenant **and** per lease, and is revocable. Rent receipts are not emailed to a tenant whose consent is `false`. Set it as the landlord with `PUT /leases/{lease_id}/lessees/{lessee_id}/consent`, ask the tenant for it with `POST /leases/{lease_id}/lessees/{lessee_id}/request-consent`, or let the tenant set it themselves from their portal with `PUT /tenant/leases/{lease_id}/consent`.
  - `consent_updated_at` string, date-time, nullable: When `electronic_delivery_consent` was last changed. `null` if never set.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[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)