Deletes the current visible value for a KV key. Missing keys produce a no-op delete acknowledgement rather than a read-style missing value.

Successful mutations return an acknowledgement that identifies the affected target, the mutation effect, and commit facts when the operation changed stored state.

Examples

Delete a key; it is no longer visible afterward.

CLI

$ strata kv put temp scratch
$ strata kv delete temp
$ strata kv exists temp

Wire

{"key":"dGVtcA==","type":"kv_put","value":"c2NyYXRjaA=="}
{"key":"dGVtcA==","type":"kv_delete"}
{"key":"dGVtcA==","type":"kv_exists"}

Parameters

Name	Type	Required	Description
key	Bytes	yes	Key bytes.

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

Returns

MutationAck<KvDelete>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.kv_key

Invocation

• CLI: strata kv delete
• Wire type: kv_delete