Write key-value pair with metadata

PUT

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/storage/kv/namespaces/{namespace_identifier}/values/{key_name}

Last modified:2022-12-16 13:48:35

Write a value identified by a key. Use URL-encoding to use special characters (e.g. :, !, %) in the key name. Body should be the value to be stored along with json metadata to be associated with the key/value pair. Existing values, expirations and metadata will be overwritten. If neither expiration nor expiration_ttl is specified, the key-value pair will never expire. If both are set, expiration_ttl is used and expiration is ignored.

Request

Path Params

key_name

string

required

namespace_identifier

string

required

account_identifier

string

required

Body Params multipart/form-data

metadata

string

required

value

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.cloudflare.com/client/v4/accounts//storage/kv/namespaces//values/' \
--form 'metadata=""' \
--form 'value=""'

Responses

🟢200Write key-value pair with metadata response

application/json

Body

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

result

required

Any of

allOf {2}

One of

null

object

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

Example

{
    "errors": [],
    "messages": [],
    "result": {},
    "success": true
}

🟢200Write key-value pair with metadata response failure

Modified at 2022-12-16 13:48:35

Read key-value pair

Query Request Analytics