Delete record
delete_recordArchive by object_type + id (soft delete; restore_record undoes it). DESTRUCTIVE: call for confirmation, then confirm:true. Covers custom objects, reports, whole quotes (lines cascade), contacts, opportunities, tasks, signals, activity, notes, forecast calls and subscriptions (no churn event; cancel_subscription records churn). Accounts refuse while any open opportunity or subscription remains; returned counts guide closing, re-pointing or marking lost first. Quote lines use update_quote. erase:true on an already-deleted record removes it and its files for good (admins, or roles they allow). Returns the archived record.
When to use: A mistaken or duplicate record should go (archive), or a deleted one must go for good.
Example: Delete that duplicate contact .
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"object_type": "<object_type>",
"id": "<id>"
},
"name": "delete_record"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | A uuid. | |
| erase | No | Boolean (true/false). | |
| confirm | No | Boolean (true/false). | |
| object_type | Yes | Object key of the record to archive, e.g. contact, opportunity, task, touch, account, report, quote, a custom object's key, or rollup / automation / field / object / pipeline (admin-only; the id from describe_schema). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| record | No | ||
| result | No | ||
| deleted | No | ||
| requires_confirm | No |