Leases
Signatures

Fully reset a signature

Completely resets all signatures for a lease by deleting all traces. This operation allows starting from scratch without keeping any history.

Action performed

This operation performs the following steps:

  1. Deletes the signature document in DO Global (signature orchestrator)
  2. Deletes all signature requests in the database
  3. Deletes the signature document in the database
  4. Resets the lease to DRAFT status

Consequences

  • All signature data is deleted (no history retained)
  • The lease can be re-initiated for a new signature
  • Previously generated PDFs remain in the media system but are no longer linked
  • No trace of the previous attempt is retained

Difference with cancel

Unlike DELETE /leases/{lease_id}/signature/cancel, this operation:

  • Completely deletes: All data is deleted (no retention)
  • No history: No trace of the previous attempt
  • Start from scratch: As if no signature was ever initiated

Use cases

Use this operation when:

  • The tenant is not responding after several days and you want to start from scratch
  • You need to completely delete an erroneous attempt
  • You want a new signature process without history
  • A major contract change requires a new document

Prerequisites

  • The lease must be in PENDING_SIGNATURE status
  • The user must have the leases:write permission
delete/leases/{lease_id}/signature/reset

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/leases/{lease_id}/signature/reset
  • Auth: HTTP bearer

Path parameters

lease_idstring uuid required

Lease ID

Response

Signature reset successfully

successboolean required

Indicates whether the reset succeeded

messagestring required

Confirmation message

Example response

{
  "success": true,
  "message": "Signature fully reset for lease 550e8400-e29b-41d4-a716-446655440001"
}

Changes

No recorded changes to this operation across all 1 revision of this API.