Skip to main content
Glama

Delete record

delete_record
Destructive

Archive 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

NameRequiredDescriptionDefault
idYesA uuid.
eraseNoBoolean (true/false).
confirmNoBoolean (true/false).
object_typeYesObject 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

NameRequiredDescriptionDefault
noteNo
recordNo
resultNo
deletedNo
requires_confirmNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / erase
      Added value: +{
      +  "description": "Boolean (true/false).",
      +  "type": [
      +    "boolean",
      +    "string",
      +    "number"
      +  ]
      +}
    • changedInput schema / properties / object_type / description
      Previous value: -"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); subscription is refused."New value: +"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)."
  2. Changed2 schema fields changed
    • removedInput schema / properties / confirm / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "number"
      -  }
      -]
    • addedInput schema / properties / confirm / type
      Added value: +[
      +  "boolean",
      +  "string",
      +  "number"
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / object_type / description
      Previous value: -"Object key of the record to archive, e.g. contact, opportunity, task, touch, account, report, quote, a custom object's key, or rollup / automation (admin-only); subscription is refused."New value: +"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); subscription is refused."
  4. Changed1 schema field changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  5. Changed6 schema fields changed
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / record / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / record / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / result / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / result / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
  6. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources