Create or modify a Key-Value pair.

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

Examples

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

Properties

key *string

The key to set the value for

value *string

The value to map to the key

kvDescription string

The description of the KV pair

kvType string

Possible Values

STRINGNUMBERBOOLEANDATETIMEDATEDURATIONJSON

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

namespace string

Default {{ flow.namespace }}

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

overwrite booleanstring

Default true

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

ttl string

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.