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:
- Deletes the signature document in DO Global (signature orchestrator)
- Deletes all signature requests in the database
- Deletes the signature document in the database
- 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
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.