---
title: "Fully reset a signature"
method: DELETE
path: "/leases/{lease_id}/signature/reset"
tags: ["Leases", "Signatures"]
---

# Fully reset a signature

`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

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

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Signature reset successfully

- ResetSignatureResponse: Response after a complete signature reset. The complete reset deletes all signature data (documents and requests) and sets the lease back to DRAFT status, allowing a new signature initiation.
  - `success` boolean, required: Indicates whether the reset succeeded
  - `message` string, required: Confirmation message

## Other responses

- `400`: The lease is not in PENDING_SIGNATURE status
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Lease not found
- `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)