Core Plugins and tasks Put

Core Plugins and tasks Put

Certified

Update an existing Key-Value entry

Renders key, value, and namespace (defaults to the Flow namespace), then writes to the namespace KV store.

Map values are deep merged (nested object keys are preserved); keyed entries like [{key: ..., value: ...}] update JSON fields (dotted paths allowed) while [{value: ...}] replaces the entire value. Set errorOnMissing to true to fail when the key is absent, otherwise a new key-value pair is created.

yaml
type: io.kestra.plugin.core.kv.Put

Replace a string value

yaml
id: kv_put_string
namespace: company.team

tasks:
  - id: update_my_string
    type: io.kestra.plugin.core.kv.Put
    key: my-string-key
    value: "new-value"

Insert or update JSON keys

yaml
id: kv_put_json
namespace: company.team

tasks:
  - id: update_my_json
    type: io.kestra.plugin.core.kv.Put
    key: my-json-key
    value:
      - key: "json-key-1"
        value: "my new value"
      - key: "nested.field"
        value: 123
Properties

Key to update

Key name within the target namespace

Value payload to write

Maps are deep merged and entry lists can replace or patch JSON fields

Defaultfalse

Fail when key is absent

Default false; when true throws before writing if the key does not exist

Default{{ flow.namespace }}

Target namespace

Defaults to the current Flow namespace; accepts expressions

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

More Plugins in this Category

Ruby
Ruby

Tasks that run Ruby scripts.

Core

4 tasks

Lua
Lua

Tasks that run Lua scripts.

Core

2 tasks