Keys

List a Namespace's Keys

GET/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/keys

Write multiple key-value pairs

Deprecated

PUT/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk

Delete multiple key-value pairs

Deprecated

POST/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/delete

Get multiple key-value pairs

Deprecated

POST/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/get

ModelsExpand Collapse

Key { name, expiration, metadata }

A name for a value. A value stored under a given key may be retrieved via the same key.

name: string

A key’s name. The name may be at most 512 bytes. All printable, non-whitespace characters are valid. Use percent-encoding to define key names as part of a URL.

maxLength512

expiration: optional number

The time, measured in number of seconds since the UNIX epoch, at which the key will expire. This property is omitted for keys that will not expire.

metadata: optional unknown

Arbitrary JSON that is associated with a key.

KeyBulkUpdateResponse { successful_key_count, unsuccessful_keys }

successful_key_count: optional number

Number of keys successfully updated.

unsuccessful_keys: optional array of string

Name of the keys that failed to be fully updated. They should be retried.

KeyBulkDeleteResponse { successful_key_count, unsuccessful_keys }

successful_key_count: optional number

Number of keys successfully updated.

unsuccessful_keys: optional array of string

Name of the keys that failed to be fully updated. They should be retried.

KeyBulkGetResponse = { values } or { values }

One of the following:

WorkersKVBulkGetResult { values }

values: optional map[string or number or boolean or map[unknown]]

Requested keys are paired with their values in an object.

One of the following:

string

number

boolean

map[unknown]

WorkersKVBulkGetResultWithMetadata { values }

values: optional map[ { metadata, value, expiration } ]

Requested keys are paired with their values and metadata in an object.

metadata: unknown

The metadata associated with the key.

value: unknown

The value associated with the key.

expiration: optional number

Expires the key at a certain time, measured in number of seconds since the UNIX epoch.