Delete

[POST] .../v1/lead/delete

Soft-deletes a CRM lead. Use this destructive method to soft-delete a CRM lead after confirming that it should no longer appear in normal lead lists or workflow boards. The method validates the lead and pipeline access, sets lde_deleted to true, writes an action log record, removes the lead-chat link with cleanup, invalidates chat caches and returns row_affected with the deleted lead id. The request body is required and id must be positive; linked clients, tickets and converted deals are not deleted by this method. The caller must have CRM lead delete permission; missing body, invalid id, missing lead, denied access, pipeline ACL failures, database errors, transaction failures and action-log errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
id Int64 Required Lead ID.

Request Example

{
  "id": 105
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [
      105
    ]
  }
}