Core Plugins and tasks Set

Core Plugins and tasks Set

Certified

Create or update a key-value entry.

Renders key, value, and namespace (defaults to flow namespace) and writes to the KV store. Supports TTL, description, type coercion (kvType), and overwrite control.

If kvType is set, the string value is parsed/validated accordingly (number, boolean, datetime, duration, JSON, etc.).

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
Properties

The key to set the value for

The value to map to the key

The description of the KV pair

Possible Values
STRINGNUMBERBOOLEANDATETIMEDATEDURATIONJSON

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

Default{{ flow.namespace }}

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

Defaulttrue

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

Reference (ref) of the pluginDefaults to apply to this task.

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