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

​
Request

​
Path Parameters

​
id
string
required
The company’s unique ID (UUID)

​
Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the companies:write permission.
Deletion is permanent and cannot be undone. Linked contacts and deals are not deleted but have their related_company_id / company_id references set to null (orphaning them). Fires the company.deleted webhook event.

​
Response

​
data
object
curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/companies/c1b2a3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Example Response

{
  "data": {
    "deleted": true,
    "id": "c1b2a3d4-e5f6-7890-abcd-ef1234567890"
  }
}
If you want to preserve linked records, reassign contacts and deals to another company (via PATCH /v1/contacts/{id} and PATCH /v1/deals/{id}) before deleting.

​
Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing companies:write permission
404company_not_foundNo company with this ID in your workspace
429rate_limitedRate limit exceeded