Worker KV Get

Worker KV Get (worker-kv-get)

Fetch a single Worker KV value and write it into an event field.

Storage json raw

Minimal example

actions:
  - worker-kv-get:
      namespace: ~

JSON

{
  "actions": [
    {
      "worker-kv-get": {
        "namespace": null
      }
    }
  ]
}

Contents

• Minimal example

• Connection

• General

• Key

• Output

A ✓ marks a field that accepts a context variable such as {{ VARIABLE }}.

Connection

Connection

Field	Type	Required	Description
namespace	string	✅	Fully-qualified Worker KV namespace (format: tenant:namespace).

General

General

Field	Type	Required	Description
description	string		Describe this step.
condition	lua-expression (string)		Only run this action if the specified condition is met. Examples: 2 * count()

Key

Key

Field	Type	Required	Description
key	string		Static key to fetch within the namespace.
key-field	field (string)		Event field selector (json pointer / dotted path / jsonpath) that yields a string key. Examples: data_field

Output

Output

Field	Type	Required	Description
output-field	field (string)		Event field selector to write the fetched value (defaults to /kv_value). Examples: data_field
warn-on-missing-key ✓	boolean (bool)		Emit a warning when key_field is missing/non-string/blank. Default: false