Skip to main content

Deleting Data

Delete Subject#

To delete/retract an entire subject, use the _id key along with only "_action": "delete". This deletes (retracts) the subject and all predicates. In addition, all of the references for that subject anywhere in the ledger are also retracted.

[  {    "_id": ["person/handle", "zsmith"],    "_action": "delete"  }]

Delete Specific Predicates#

To delete only specific predicate-objects within an subject, specify the key/value combinations.

You can delete (retract) a single predicate by setting the value of _id to a two-tuple of the predicate and predicate value, and then setting the predicate to null. "_action": "delete" is inferred.

[  {    "_id": ["person/handle", "jdoe"],    "age": null  }]

Delete Specific Multi Predicates#

To delete (retract) only a single object from a multi predicate, specify the predicate-object, and add "_action": "delete"

For example, to delete just the number, 98, from ["person/handle", "jdoe"]'s favorite numbers, we would issue:

[  {    "_id": ["person/handle", "jdoe"],    "favNums": [98],    "_action": "delete"  }]

To delete all of ["person/handle", "jdoe"]'s favorite numbers, we would issue:

[  {    "_id": ["person/handle", "jdoe"],    "favNums": null  }]