delete_reference_doc
Soft-delete a reference doc with version control, making it recoverable via restore. Prevents deletion if conflicts or stale version.
Instructions
Delete a reference_doc. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_reference_doc (it will not appear in list_reference_docs until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).
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": {
"id": "<id>",
"expectedVersion": "<expectedVersion>",
"confirm": "<confirm>"
},
"name": "delete_reference_doc"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The reference_doc's id. | |
| confirm | Yes | Must be true. Acknowledges you understand this is destructive. | |
| expectedVersion | Yes | The version you last read — rejected with 409 if stale. |