Reference
Workers KV
Keys in one Workers KV namespace, readable back through the API.
Keys in one Workers KV namespace, readable back through the API.
Connection
| What | This provider |
|---|---|
| Vendor | Cloudflare |
| Key | cloudflare-workers-kv |
| Availability | available. You can connect it today. |
| Credential we hold | cloudflare-token |
| Values read back | yes |
| Activation | immediate |
Directions
| Direction | What it does |
|---|---|
import | We read names and values out of the store into your environment. |
export | We write names and values from your environment into the store. |
Activation
immediate. The running app sees a new value at once.
Conflict policies
| Direction | Policies you can pick |
|---|---|
import | skip_existing, new_version, fail |
export | create_only, overwrite, overwrite_and_prune |
How syncs work says what each one does.
Connect
Paste a credential from the vendor. We seal it and never show it again.
| Field | Label | Kind | Required | What it is |
|---|---|---|---|---|
apiToken | API token | secret; we mask it here and seal it | yes |
Connection fields
You set these when you connect. Every mapping on the connection shares them.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
accountId | Account ID | text | yes | no | Workers & Pages in the dashboard shows it in the right-hand column. |
Mapping fields
You answer these once per environment you map.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
namespaceId | Namespace | text | yes | no | One namespace holds one environment. |
keyPrefix | Key prefix | text | no | yes | Limits this sync to keys starting with it. Pruning permanently deletes every key in reach, including ones this sync did not write. |
Required permissions
We probe for these when we verify the connection.
| Permission | Directions | Blocking | Without it |
|---|---|---|---|
Account Settings:Read | every direction | yes | We cannot confirm the token reaches this account. |
Workers KV Storage:Read | import | yes | Import cannot read any value in the namespace. |
Workers KV Storage:Edit | export | yes | Export cannot write or remove a key. |