{"version":"2.1.273","anchor":"artifact-document-tool-delete-sentinel-added-for-fiel","canonical_anchor":"artifact-document-tool-delete-sentinel-added-for-fiel","heading":"Document write tools document a __delete__ sentinel for removing fields","tier":"use","area":"Artifacts","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.273\/e\/artifact-document-tool-delete-sentinel-added-for-fiel","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.273","markdown":"### Document write tools document a __delete__ sentinel for removing fields\n\nThe artifact\/db write tool's documentation now explains how to delete a field during an update using __delete__\n\n**What**\n\nThe parameter description for the artifact document-write tool (`write_db`) now documents that, when updating a document, you can remove a field entirely by setting it to `{\"__delete__\": true}` in the `data`\/`file_path` payload.\n\n**Why**\n\nThis makes an existing capability discoverable: previously it wasn't documented how to delete a field via an update, so callers might not have known this shorthand existed.\n\n- Area: Artifacts\n- Names: `__delete__`\n- Tier: Use it now\n- Useful: 3\/5\n- Signal: 1\/5"}