Changes data

quotecloud_remove_document_data_item

Remove a data item (merge field) from one document: the document’s copy of the definition and its value are removed, so merge fields referencing it render blank. A definition that exists only on this document is soft-deleted as well; a company-wide definition is never changed or deleted by this tool: it is only unlinked from this document. Dangerous: always answered first with status confirmation_required, a preview and a one-time confirmToken; re-send the identical arguments with the token to apply. Works in either contentMode and on documents stored only in the data file. Acquires the editor lease and the settings lock. Requires documents:write and only runs when documents.edit is enabled; on a template also templates.contentEdits and manageDocumentTemplates.

Inputs

documentIdRequired
Convex document ID or company-scoped numeric display ID. string
lockTokenRequired
Stable opaque token for this agent edit session. Reuse it to heartbeat owned element locks. string
dataItemIdRequired
The QC_dataItems id reported by quotecloud_list_custom_data_definitions. string
confirmTokenOptional
One-time code from the preview. Send it with otherwise identical inputs to run the change. string