---
title: KV store
summary: These endpoints are used to create, describe, list, and delete KV stores.
url: https://www.fastly.com/documentation/reference/api/services/resources/kv-store
---

These endpoints are used to create, describe, list, and delete KV stores.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `name` | string | A human-readable name for the store. Refer to <a href="https://docs.fastly.com/products/compute-resource-limits#kv-store">https://docs.fastly.com/products/compute-resource-limits#kv-store</a> for limitations on the KV store name. |

## API endpoints

### List all KV stores

**GET** `/resources/stores/kv`

List all KV stores.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `cursor` | string | query | No | To be used for paginating through results. |
| `limit` | integer | query | No | The maximum number of KV stores to include in the response. |
| `name` | string | query | No | Returns a one-element array containing the details for the named KV store. |

### Create a KV store

**POST** `/resources/stores/kv`

Create a KV store.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `location` | string | query | No | Region where the KV store will be located. |

### Describe a KV store

**GET** `/resources/stores/kv/{store_id}`

Get details of a KV store.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `store_id` | string | path | Yes | ID of the store. |

### Update a KV store

**PUT** `/resources/stores/kv/{store_id}`

Update the name of a KV store.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `store_id` | string | path | Yes | ID of the store. |

### Delete a KV store

**DELETE** `/resources/stores/kv/{store_id}`

A KV store must be empty before it can be deleted. Attempting to delete a KV store that contains items will result in a response with a <code>409</code> status code.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `store_id` | string | path | Yes | ID of the store. |