Skip to main content
DELETE
/
v1
/
deals
/
{id}
Delete Deal
curl --request DELETE \
  --url https://api.example.com/v1/deals/{id}
{
  "data": {
    "deleted": true,
    "id": "<string>"
  }
}

Request

Path Parameters

id
string
required
The deal’s unique ID (UUID)

Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the deals:write permission.
Deletion is permanent and cannot be undone. Activities, tasks, and notes linked to this deal become orphaned (their deal_id is set to null) but are not deleted. Fires the deal.deleted webhook event.

Response

data
object
curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/deals/3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "deleted": true,
    "id": "3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a"
  }
}

Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing deals:write permission
404deal_not_foundNo deal with this ID in your workspace
429rate_limitedRate limit exceeded