Create a Namespace

POST

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

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

Creates a namespace under the given title. A 400 is returned if the account already owns a namespace with this title. A namespace must be explicitly deleted to be replaced.

Request

Path Params

account_identifier

string

required

Body Params application/json

title

string

required

A human-readable string name for a Namespace.

Example:

My Own Namespace

Example

{
    "title": "My Own Namespace"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//storage/kv/namespaces' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "My Own Namespace"
}'

Responses

🟢200Create a Namespace response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object (namespace)

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "id": "0f2ac74b498b48028cb68387c421e279",
        "supports_url_encoding": true,
        "title": "My Own Namespace"
    },
    "success": true
}

🟢200Create a Namespace response failure

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

List Namespaces

Remove a Namespace