Delete

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

Soft-deletes a CRM lead. 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, marks the lead as deleted, removes the lead-chat link 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, storage errors are returned as HTTP 200 ErrorResult.

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
    ]
  }
}