Penv Cloud
Start free
Docs
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

WhatThis provider
VendorCloudflare
Keycloudflare-workers-kv
Availabilityavailable. You can connect it today.
Credential we holdcloudflare-token
Values read backyes
Activationimmediate

Directions

DirectionWhat it does
importWe read names and values out of the store into your environment.
exportWe write names and values from your environment into the store.

Activation

immediate. The running app sees a new value at once.

Conflict policies

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_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.

FieldLabelKindRequiredWhat it is
apiTokenAPI tokensecret; we mask it here and seal ityes

Connection fields

You set these when you connect. Every mapping on the connection shares them.

FieldLabelKindRequiredAdvancedWhat it is
accountIdAccount IDtextyesnoWorkers & Pages in the dashboard shows it in the right-hand column.

Mapping fields

You answer these once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
namespaceIdNamespacetextyesnoOne namespace holds one environment.
keyPrefixKey prefixtextnoyesLimits 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.

PermissionDirectionsBlockingWithout it
Account Settings:Readevery directionyesWe cannot confirm the token reaches this account.
Workers KV Storage:ReadimportyesImport cannot read any value in the namespace.
Workers KV Storage:EditexportyesExport cannot write or remove a key.