Workers KV

Keys in one Workers KV namespace, readable back through the API.

The connection

What	This provider
Vendor	Cloudflare
Key	`cloudflare-workers-kv`
Availability	`available`. You can connect it today.
Credential penv holds	`cloudflare-token`
Values read back	yes
Activation	`immediate`

Direction	What it does
`import`	Reads names and values out of the store into penv.
`export`	Writes names and values from penv into the store.

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

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.

You paste a credential you already hold. penv seals it and never shows it again.

Field	Label	Kind	Required	What it is
`apiToken`	API token	secret, masked here and sealed	yes

Fixed when you connect, and shared by every mapping on it.

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.

Answered 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.

penv probes for these when it verifies 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.