> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Delete CRM record

> Move a record to the trash, where it can be restored for 30 days; a company with open opportunities is refused.

Moves a record to the trash. Its notes, tasks and list entries disappear with it and return when the
record is restored in the app. The record's domains and addresses become free for other records. The
API cannot restore or empty the trash.

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to delete the type. Recorded in the audit log with the token's name. A second call answers `404`.

## Path parameters

**id** `string` *required*

The record.

## Response

**data** `object` *required*

**properties**

**id** `string` *required*

The deleted record.

```bash cURL theme={"dark"}
curl -X DELETE "https://your-collabase.ch/api/v1/crm/records/cm3rec0001" \
  -H "Authorization: Bearer cb_xYz123ABCD..."
```

```json 200 theme={"dark"}
{ "data": { "id": "cm3rec0001" } }
```

```json 409 theme={"dark"}
{ "error": { "code": "CRM_RECORD_HAS_OPEN_OPPORTUNITIES", "message": "The company still has open deals." } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.