API Reference

KV

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Namespaces

List Namespaces

client.kv.namespaces.list(NamespaceListParams { account_id, direction, order, 2 more } params, RequestOptionsoptions?): V4PagePaginationArray<Namespace { id, title, supports_url_encoding } >

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

Get a Namespace

client.kv.namespaces.get(stringnamespaceId, NamespaceGetParams { account_id } params, RequestOptionsoptions?): Namespace { id, title, supports_url_encoding }

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

Create a Namespace

client.kv.namespaces.create(NamespaceCreateParams { account_id, title } params, RequestOptionsoptions?): Namespace { id, title, supports_url_encoding }

POST/accounts/{account_id}/storage/kv/namespaces

Rename a Namespace

client.kv.namespaces.update(stringnamespaceId, NamespaceUpdateParams { account_id, title } params, RequestOptionsoptions?): Namespace { id, title, supports_url_encoding }

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

Remove a Namespace

client.kv.namespaces.delete(stringnamespaceId, NamespaceDeleteParams { account_id } params, RequestOptionsoptions?): NamespaceDeleteResponse | null

DELETE/accounts/{account_id}/storage/kv/namespaces/{namespace_id}

Write multiple key-value pairs

client.kv.namespaces.bulkUpdate(stringnamespaceId, NamespaceBulkUpdateParams { account_id, body } params, RequestOptionsoptions?): NamespaceBulkUpdateResponse { successful_key_count, unsuccessful_keys } | null

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

Delete multiple key-value pairs

client.kv.namespaces.bulkDelete(stringnamespaceId, NamespaceBulkDeleteParams { account_id, body } params, RequestOptionsoptions?): NamespaceBulkDeleteResponse { successful_key_count, unsuccessful_keys } | null

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

Get multiple key-value pairs

client.kv.namespaces.bulkGet(stringnamespaceId, NamespaceBulkGetParams { account_id, keys, type, withMetadata } params, RequestOptionsoptions?): NamespaceBulkGetResponse | null

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

ModelsExpand Collapse

Namespace { id, title, supports_url_encoding }

id: string

Namespace identifier tag.

maxLength32

title: string

A human-readable string name for a Namespace.

maxLength512

supports_url_encoding?: boolean

True if keys written on the URL will be URL-decoded before storing. For example, if set to "true", a key written on the URL as "%3F" will be stored as "?".

NamespaceDeleteResponse

NamespaceBulkUpdateResponse { successful_key_count, unsuccessful_keys }

successful_key_count?: number

Number of keys successfully updated.

unsuccessful_keys?: Array<string>

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

NamespaceBulkDeleteResponse { successful_key_count, unsuccessful_keys }

successful_key_count?: number

Number of keys successfully updated.

unsuccessful_keys?: Array<string>

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

NamespaceBulkGetResponse = WorkersKVBulkGetResult { values } | WorkersKVBulkGetResultWithMetadata { values } | null

One of the following:

WorkersKVBulkGetResult { values }

values?: Record<string, string | number | boolean | Record<string, unknown>>

Requested keys are paired with their values in an object.

One of the following:

string

number

boolean

Record<string, unknown>

WorkersKVBulkGetResultWithMetadata { values }

values?: Record<string, Values | null>

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?: number

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

NamespacesKeys

List a Namespace's Keys

client.kv.namespaces.keys.list(stringnamespaceId, KeyListParams { account_id, cursor, limit, prefix } params, RequestOptionsoptions?): CursorLimitPagination<Key { name, expiration, metadata } >

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

Write multiple key-value pairs

Deprecated

client.kv.namespaces.keys.bulkUpdate(stringnamespaceId, KeyBulkUpdateParams { account_id, body } params, RequestOptionsoptions?): KeyBulkUpdateResponse { successful_key_count, unsuccessful_keys } | null

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

Delete multiple key-value pairs

Deprecated

client.kv.namespaces.keys.bulkDelete(stringnamespaceId, KeyBulkDeleteParams { account_id, body } params, RequestOptionsoptions?): KeyBulkDeleteResponse { successful_key_count, unsuccessful_keys } | null

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

Get multiple key-value pairs

Deprecated

client.kv.namespaces.keys.bulkGet(stringnamespaceId, KeyBulkGetParams { account_id, keys, type, withMetadata } params, RequestOptionsoptions?): KeyBulkGetResponse | null

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?: 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?: unknown

Arbitrary JSON that is associated with a key.

KeyBulkUpdateResponse { successful_key_count, unsuccessful_keys }

successful_key_count?: number

Number of keys successfully updated.

unsuccessful_keys?: Array<string>

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

KeyBulkDeleteResponse { successful_key_count, unsuccessful_keys }

successful_key_count?: number

Number of keys successfully updated.

unsuccessful_keys?: Array<string>

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

KeyBulkGetResponse = WorkersKVBulkGetResult { values } | WorkersKVBulkGetResultWithMetadata { values } | null

One of the following:

WorkersKVBulkGetResult { values }

values?: Record<string, string | number | boolean | Record<string, unknown>>

Requested keys are paired with their values in an object.

One of the following:

string

number

boolean

Record<string, unknown>

WorkersKVBulkGetResultWithMetadata { values }

values?: Record<string, Values | null>

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?: number

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

NamespacesMetadata

Read the metadata for a key

client.kv.namespaces.metadata.get(stringnamespaceId, stringkeyName, MetadataGetParams { account_id } params, RequestOptionsoptions?): MetadataGetResponse

GET/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/metadata/{key_name}

ModelsExpand Collapse

MetadataGetResponse = unknown

Arbitrary JSON that is associated with a key.

NamespacesValues

Read key-value pair

client.kv.namespaces.values.get(stringnamespaceId, stringkeyName, ValueGetParams { account_id } params, RequestOptionsoptions?): Response

GET/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}

Write key-value pair with optional metadata

client.kv.namespaces.values.update(stringnamespaceId, stringkeyName, ValueUpdateParams { account_id, value, expiration, 2 more } params, RequestOptionsoptions?): ValueUpdateResponse | null

PUT/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}

Delete key-value pair

client.kv.namespaces.values.delete(stringnamespaceId, stringkeyName, ValueDeleteParams { account_id } params, RequestOptionsoptions?): ValueDeleteResponse | null

DELETE/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/values/{key_name}

ModelsExpand Collapse

ValueUpdateResponse

ValueDeleteResponse