sync

Delete a file from the primary vault. Optional CAS via base_sha to detect concurrent multi-PC writes. Protected paths (global/memory/, global/skills/, global/planning/, global/intent/, global/claude-config/, handoffs/) require base_sha or explicit force:true (audited). Idempotent: deleting a non-existent path returns success with deleted:false.

Delete a file from the primary vault. Optional CAS via base_sha to detect concurrent multi-PC writes. Protected paths (global/memory/, global/skills/, global/planning/, global/intent/, global/claude-config/, handoffs/) require base_sha or explicit force:true (audited). Idempotent: deleting a non-existent path returns success with deleted:false.

post/api/mcp/tools/sync_delete

Request

  • Base URL: https://api.ainote.dev
  • URL: https://api.ainote.dev/api/mcp/tools/sync_delete
  • Auth: API key in header Authorization

Request body

pathstring required

Relative file path to delete (e.g., 'global/_waf_probe.md'). No leading slash, no '..'.

base_shastring

Optional: git_sha the client last observed for this path. When present, server compares with current git_sha and returns -32009 conflict on mismatch (with current content for 3-way diff).

device_idstring

Optional: client device identifier for audit log (e.g., from ~/.claude/ainote-sync/device.id).

forceboolean

Optional: when true, skip CAS check even if base_sha is supplied. Use only for intentional overwrites; presence is auditable via warning logs.

Response

Tool executed successfully

Changes

No recorded changes to this operation across all 1 revision of this API.