---
title: "Initiate amendment electronic signature"
method: POST
path: "/leases/{lease_id}/amendments/{amendment_id}/initiate-signature"
tags: ["Leases"]
---

# Initiate amendment electronic signature

`POST /leases/{lease_id}/amendments/{amendment_id}/initiate-signature`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/amendments/{amendment_id}/initiate-signature`
- Auth: HTTP bearer

Initiate the electronic signature workflow for an amendment.

**Prerequisites:**
- Amendment must be in `DRAFT` or `PENDING_SIGNATURE` status
- No active signature process already in progress

**Flow:**
1. Generates the amendment PDF (Typst template)
2. Uploads the PDF to secure storage
3. Creates a `DocumentSignature` record with `document_type: AMENDMENT`
4. Creates `SignatureRequest` for each signer (owner + tenants)
5. Publishes signature events (Scaleway Topics)
6. Transitions amendment to `PENDING_SIGNATURE`

Returns the signature process details including PDF URL and signer list.

## Path parameters

- `lease_id` string, uuid, required
- `amendment_id` string, uuid, required

## Request body

- InitiateAmendmentSignatureDto: Data for initiating the electronic signature of an amendment
  - `initiator_id` string, uuid, required: ID of the user initiating the signature process
  - `initiator_signer_type` 'proprietaire' | 'locataire' | 'agent_immobilier' | 'caution': Who is signing. **Always lowercase** on the wire. `caution` is deliberately distinct from `locataire`: a surety does not sign the lease, they sign their own surety deed, on which they must themselves write the mention required by article 2297 of the Civil Code: without it their undertaking is void.

## Response `200`

Signature process initiated successfully

- InitiateSignatureResponse: Response after initiating a signature
  - `document_signature_id` string, uuid, required: Unique ID of the signature process
  - `event_id` string, required: Unique event ID for traceability
  - `pdf_url` string, uri, required: Absolute URL of the PDF document to sign
  - `media_id` string, uuid, required: Reference to the media table (PDF document)
  - `signature_requests` SignatureRequestSummary[], required: List of created signature requests
    - `id` string, uuid, required: Signature request ID
    - `signer_type` 'proprietaire' | 'locataire' | 'agent_immobilier' | 'caution', required: Who is signing. **Always lowercase** on the wire. `caution` is deliberately distinct from `locataire`: a surety does not sign the lease, they sign their own surety deed, on which they must themselves write the mention required by article 2297 of the Civil Code: without it their undertaking is void.
    - `signer_email` string, email, required: Signer email
    - `status` 'PENDING' | 'OTP_SENT' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required: Status of an individual signature request
    - `expires_at` string, date-time, required: Request expiration date
  - `status` 'READY' | 'SIGNING' | 'COMPLETED' | 'FAILED' | 'ARCHIVED', required: Status of the document signature process

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: A signature process is already in progress for this amendment
- `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)