> **Source:** https://knowledge.leegality.com/sign-station/api/delete-user > **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 /api/v1/users/{id} — Delete user Soft deletes a user by ID (sets enabled=false). Prevents deletion of the last admin user. **Authentication:** `X-Auth-Token` header required on every request. ## Request URL ``` DELETE https://app1.leegality.com/api/api/v1/users/{id} ``` **Environments:** - Production: `https://app1.leegality.com/api/api/v1/users/{id}` - Sandbox: `https://sandbox.leegality.com/api/api/v1/users/{id}` --- ## Parameters | Name | In | Required | Type | Description | Example | |------|----|----------|------|-------------|---------| | `id` | path | Yes | string | ID of the user to be deleted. | — | --- ## Responses ### 200 — User disabled successfully | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Response code indicating success or failure | `LE_SS_002` | | `message` | string | No | Response message providing additional information | `Requested record has been deleted.` | | `data` | object | No | Additional data related to the response, if any. | — | ### 400 — Cannot delete the last admin user | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_400` | | `errors` | array\ | No | List of error details See **ErrorDetailDeleteUser400VO** below. | — | #### ErrorDetailDeleteUser400VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Cannot delete the last admin user. The system must have at l` | | `path` | string | No | API path that generated the error | `/api/v1/users/{id}` | | `code` | string | No | Specific error code | `null` | ### 401 — Unauthorized - Invalid or expired token | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_401` | | `errors` | array\ | No | List of error details See **ErrorDetail401Unauthorized** below. | — | #### ErrorDetail401Unauthorized | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Invalid or expired token` | | `path` | string | No | API path that generated the error | `/api/v1/*` | | `code` | string | No | Specific error code | `LE_ERR_SS_303` | ### 404 — User not found | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_404` | | `errors` | array\ | No | List of error details See **ErrorDetailDeleteUser404VO** below. | — | #### ErrorDetailDeleteUser404VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `f6b0449d-b866-4647-b5c5-9ce765eb1182 does not exist.` | | `path` | string | No | API path that generated the error | `/api/v1/users/f6b0449d-b866-4647-b5c5-9ce765eb1182` | | `code` | string | No | Specific error code | `LE_ERR_SS_001` | ### 500 — Internal server error | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `code` | string | No | Top-level error code | `LE_ERR_SS_500` | | `errors` | array\ | No | List of error details See **ErrorDetailToken500VO** below. | — | #### ErrorDetailToken500VO | Field | Type | Required | Description | Example | |-------|------|----------|-------------|---------| | `message` | string | No | Detailed error message | `Internal Server Error` | | `path` | string | No | API path that generated the error | `null` | | `code` | string | No | Specific error code | `null` | ### Sample Response (200) ```json { "code": "LE_SS_002", "message": "Requested record has been deleted.", "data": {} } ```