Docs menu · Reference

Deletes multiple document/path entries and returns one positional mutation result per entry. Missing documents and paths are represented as no-op item results; applied items share one engine commit.

Itemwise batches return one positional item result per input item. The outer batch status summarizes whether all, some, or none of the items succeeded.

Examples

Delete many documents in one commit.

CLI

$ strata command run --command-json '{"entries":[{"key":"a","path":"$","value":{"v":1}}],"type":"json_batch_set"}'
$ strata command run --command-json '{"entries":[{"key":"a","path":"$"}],"type":"json_batch_delete"}'
$ strata json exists a

Wire

{"entries":[{"key":"a","path":"$","value":{"v":1}}],"type":"json_batch_set"}
{"entries":[{"key":"a","path":"$"}],"type":"json_batch_delete"}
{"key":"a","type":"json_exists"}

Parameters

NameTypeRequiredDescription
entriesBatchJsonDeleteEntry[]yesEntries to delete.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

BatchResult<JsonMutationItem>.

Errors

Invocation

  • CLI: via strata command run (no dedicated verb)
  • Wire type: json_batch_delete

agents: this page as markdown → /docs/reference/json/batch_delete.md