---
title: Config store item
summary: >-
  A key-value pair within a config store. <a
  href="https://www.fastly.com/documentation/guides/concepts/edge-state/dynamic-config">Learn
  more about config stores</a>.
url: >-
  https://www.fastly.com/documentation/reference/api/services/resources/config-store-item
---

A key-value pair within a config store. <a href="https://www.fastly.com/documentation/guides/concepts/edge-state/dynamic-config">Learn more about config stores</a>.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `item_key` | string | Item key, maximum 256 characters. |
| `item_value` | string | Item value, maximum 8000 characters. |
| `items` | array |  |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `store_id` | string | An alphanumeric string identifying the config store. (Read-only) |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### List items in a config store

**GET** `/resources/stores/config/{config_store_id}/items`

List the key-value pairs associated with a given config store ID.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |

### Update multiple entries in a config store

**PATCH** `/resources/stores/config/{config_store_id}/items`

Add multiple key-value pairs to an individual config store, specified by ID.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |

### Create an entry in a config store

**POST** `/resources/stores/config/{config_store_id}/item`

Add a single key-value pair to an individual config store, specified by ID.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |

### Get an item from a config store

**GET** `/resources/stores/config/{config_store_id}/item/{config_store_item_key}`

Retrieve a config store entry given a config store ID and item key.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |
| `config_store_item_key` | string | path | Yes | Item key, maximum 256 characters. |

### Insert or update an entry in a config store

**PUT** `/resources/stores/config/{config_store_id}/item/{config_store_item_key}`

Insert or update an entry in a config store given a config store ID, item key, and item value.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |
| `config_store_item_key` | string | path | Yes | Item key, maximum 256 characters. |

### Delete an item from a config store

**DELETE** `/resources/stores/config/{config_store_id}/item/{config_store_item_key}`

Delete an entry in a config store given a config store ID, and item key.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |
| `config_store_item_key` | string | path | Yes | Item key, maximum 256 characters. |

### Update an entry in a config store

**PATCH** `/resources/stores/config/{config_store_id}/item/{config_store_item_key}`

Update an entry in a config store given a config store ID, item key, and item value.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `config_store_id` | string | path | Yes | An alphanumeric string identifying the config store. |
| `config_store_item_key` | string | path | Yes | Item key, maximum 256 characters. |