Create or modify a Key-Value pair.

yaml
type: "io.kestra.plugin.core.kv.set"

Set the task's uri output as a value for orders_file key.

yaml
id: kv_store_set
namespace: company.team

tasks:
  - id: http_download
    type: io.kestra.plugin.core.http.Download
    uri: https://huggingface.co/datasets/kestra/datasets/raw/main/csv/orders.csv

  - id: kv_set
    type: io.kestra.plugin.core.kv.Set
    key: orders_file
    value: "{{ outputs.http_download.uri }}"
    kvType: STRING

Dynamic YES

The key to set the value for

Dynamic YES

The value to map to the key

Dynamic YES

The description of the KV pair

Dynamic YES

Possible Values

STRINGNUMBERBOOLEANDATETIMEDATEDURATIONJSON

Enum representing the data type of the KV pair. If not set, the value will be stored as a string.

Dynamic YES

Default {{ flow.namespace }}

The namespace in which the KV pair will be stored – by default, Kestra will use the namespace of the flow.

Dynamic NO

Default true

Flag specifying whether to overwrite or fail if a value for the given key already exists.

Dynamic YES

Format duration

Optional Time-To-Live (TTL) duration for the key-value pair. If not set, the KV pair will never be deleted from internal storage.