--- title: Create a namespace --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [KV](https://developers.cloudflare.com/api/python/resources/kv) [Namespaces](https://developers.cloudflare.com/api/python/resources/kv/subresources/namespaces) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a namespace kv.namespaces.create(NamespaceCreateParams\*\*kwargs) -> [Namespace]() POST/accounts/{account\_id}/storage/kv/namespaces Creates a Workers KV namespace in the specified account with the given title. Returns `400` if the account already owns a namespace with that title; an existing namespace must be explicitly deleted before it can be replaced. An optional jurisdiction restricts where data is durably stored and can only be set at creation time. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Workers KV Storage Write` ##### ParametersExpand Collapse account\_id: str ID of the Cloudflare account that owns the Workers KV namespaces. maxLength32 [Link to this property](<#(resource)%20kv.namespaces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) title: str Human-readable string name for a Workers KV namespace. maxLength512 [Link to this property](<#(resource)%20kv.namespaces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20title%20%3E%20(schema)>)
jurisdiction: Optional\[Literal\["eu", "fedramp", "us"]] Specify the jurisdiction to restrict the KV namespace to durably store data within. Can only be set at namespace creation time. One of the following: "eu" Link to this property "fedramp" Link to this property "us" Link to this property
[Link to this property](<#(resource)%20kv.namespaces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20jurisdiction%20%3E%20(schema)>) mode: Optional\[Literal\["instant"]] The mode of the Workers KV namespace. Specify `instant` when creating a namespace to create a KV Instant namespace. Omit this field when creating a namespace to create a classic namespace. Currently, `instant` is the only supported explicit value. [Link to this property](<#(resource)%20kv.namespaces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20mode%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Namespace: … id: str ID of the Workers KV namespace. maxLength32 Link to this property title: str Human-readable string name for a Workers KV namespace. maxLength512 Link to this property
jurisdiction: Optional\[Literal\["eu", "fedramp", "us"]] Specify the jurisdiction to restrict the KV namespace to durably store data within. Can only be set at namespace creation time. One of the following: "eu" Link to this property "fedramp" Link to this property "us" Link to this property
Link to this property mode: Optional\[Literal\["instant"]] The mode of the Workers KV namespace. Specify instant when creating a namespace to create a KV Instant namespace. Omit this field when creating a namespace to create a classic namespace. Currently, instant is the only supported explicit value. Link to this property supports\_url\_encoding: Optional\[bool] 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 ”?”. Link to this property
[Link to this property](<#(resource)%20kv.namespaces%20%3E%20(model)%20namespace%20%3E%20(schema)>) ### Create a namespace Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) namespace = client.kv.namespaces.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", title="My Own Namespace", ) print(namespace.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "0f2ac74b498b48028cb68387c421e279", "title": "My Own Namespace", "jurisdiction": "eu", "mode": "instant", "supports_url_encoding": true } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "0f2ac74b498b48028cb68387c421e279", "title": "My Own Namespace", "jurisdiction": "eu", "mode": "instant", "supports_url_encoding": true } } ```