Files
sonr/docs/reference/messages/dwn-delete-record.mdx
T

43 lines
1.0 KiB
Plaintext
Raw Normal View History

2025-10-03 14:45:52 -04:00
---
title: Delete DWN Record
description: Remove records from your personal data vault with optional cascading deletion
2026-09-02 16:53:38 -04:00
seo:
title: "DWN Record Deletion"
2025-10-03 14:45:52 -04:00
---
2026-09-02 16:53:38 -04:00
:::warning
Record deletion is **permanent** and cannot be undone. Ensure you have backups if needed.
:::
2025-10-03 14:45:52 -04:00
## Deletion Options
### Standard Deletion
- Removes only the specified record
- Child records remain intact
- Preserves hierarchical structure
### Pruned Deletion (`prune: true`)
- Removes the record and all descendants
- Cascades through entire subtree
- Useful for removing complete data structures
## Authorization Requirements
You must have one of the following:
- **Owner**: Be the record author
- **Permission**: Have explicit delete permission
- **Protocol Authority**: Have protocol-level delete rights
2026-09-02 16:53:38 -04:00
:::note
The `deletedCount` in the response includes all pruned child records.
:::
2025-10-03 14:45:52 -04:00
## Safety Considerations
2026-09-02 16:53:38 -04:00
:::tip
Query child records before pruning to understand the impact:
```bash
snrd query dwn records-query --parent-id <record_id>
```
:::