
Core Plugins and tasks Set
CertifiedCreate or update a key-value entry.
Core Plugins and tasks Set
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.).
type: io.kestra.plugin.core.kv.SetExamples
Set the task's uri output as a value for orders_file key.
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 *Requiredstring
The key to set the value for
value *Requiredstring
The value to map to the key
kvDescription string
The description of the KV pair
kvType string
STRINGNUMBERBOOLEANDATETIMEDATEDURATIONJSONEnum representing the data type of the KV pair. If not set, the value will be stored as a string.
namespace string
{{ flow.namespace }}The namespace in which the KV pair will be stored – by default, Kestra will use the namespace of the flow.
overwrite booleanstring
trueFlag specifying whether to overwrite or fail if a value for the given key already exists.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
ttl string
Optional Time-To-Live (TTL) duration for the key-value pair. If not set, the KV pair will never be deleted from internal storage.