> **Source:** https://knowledge.leegality.com/document-execution/api/delete-invitation > **Site:** Leegality Knowledge Base — https://knowledge.leegality.com > **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration. > **Navigation:** Every article on this site has a plain-text version at `.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt > **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt --- # DELETE /v3.0/sign/request/invitation — Delete invitation Deletes an unsigned invitation from a document, permanently removing the invitee's access. **Authentication:** `X-Auth-Token` header required on every request. ## Request URL ``` DELETE https://app1.leegality.com/api/v3.0/sign/request/invitation?signUrl={signUrl} ``` **Environments:** - Production: `https://app1.leegality.com/api/v3.0/sign/request/invitation` - Sandbox: `https://sandbox.leegality.com/api/v3.0/sign/request/invitation` --- ## Parameters | Name | In | Required | Type | Description | Example | |------|----|----------|------|-------------|---------| | `signUrl` | query | Yes | string | Signature URL of the invitation to delete. **Format:** Either the full sign URL or just the UUID portion. Both formats are accepted: - Full URL: `https://sandbox.leegality.com/sign/db9f8b15-84be-47e4-a885-66cdce4bc80c` - UUID only: `db9f8b15-84be-47e4-a885-66cdce4bc80c` Get from the **Create eSigning request** API response (`invitations[].signUrl`) or from the **Check document details** API response. | — | --- ## Responses ### 200 — Delete invitation response. Check `status` field: `1` = success, `0` = failure. Response wrapper for the Delete Invitation API. On success (`status: 1`), `data` is an empty object and `messages` contains `invitation.deleted.success`. On failure (`status: 0`), `data` is an empty object and `messages` contains the error details. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `status` | integer | No | API response status. `1` = success (invitation deleted), `0` = failure. Allowed: `0`, `1`. | `1` | | `messages` | array\ | No | Array of response messages. **Success codes:** - `invitation.deleted.success` — Invitation deleted successfully. The invitee will no longer be able to access the document. **Error codes:** - `sign.url.required` — The `signUrl` query parameter is missing or empty - `invitation.not.exists` — The invitation was not found. This can mean: - The sign URL is invalid or does not exist - The invitation has already been signed (signed invitations cannot be deleted) - The invitation was already deleted - The document is completed See **Message** below. | — | | `data` | object | No | Always an empty object `{}` for this endpoint. | — | #### Message Message object containing a machine-readable code and a human-readable description. Used for success confirmations, errors, and warnings. | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Response message code. | `simpleWorkFlow.success` | | `message` | string | No | Human-readable success or error message. | `Invitations sent successfully.` | ### Sample Response (200) ```json { "status": 1, "messages": [ { "code": "simpleWorkFlow.success", "message": "Invitations sent successfully." } ], "data": {} } ```