Skip to content

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

Connection

Connection
FieldTypeRequiredDescription
namespacestringFully-qualified Worker KV namespace (format: tenant:namespace).

General

General
FieldTypeRequiredDescription
descriptionstringDescribe this step.
conditionlua-expression (string)Only run this action if the specified condition is met.
Examples: 2 * count()

Key

Key
FieldTypeRequiredDescription
keystringStatic key to fetch within the namespace.
key-fieldfield (string)Event field selector (json pointer / dotted path / jsonpath) that yields a string key.
Examples: data_field

Output

Output
FieldTypeRequiredDescription
output-fieldfield (string)Event field selector to write the fetched value (defaults to /kv_value).
Examples: data_field
warn-on-missing-keyboolean (bool)Emit a warning when key_field is missing/non-string/blank.
Default: false