---
title: "POST /key-value-stores/{KvsARN}/keys#If-Match"
method: POST
path: "/key-value-stores/{KvsARN}/keys#If-Match"
---

# POST /key-value-stores/{KvsARN}/keys#If-Match

`POST /key-value-stores/{KvsARN}/keys#If-Match`

Puts or Deletes multiple key value pairs in a single, all-or-nothing operation.

## Path parameters

- `KvsARN` string, required

## Headers

- `If-Match` string, required

## Request body

- object
  - `Puts` PutKeyRequestListItem[] — List of key value pairs to put.
    - `Key` string, required — The key of the key value pair list item to put.
    - `Value` string, password, required — The value for the key value pair to put.
  - `Deletes` DeleteKeyRequestListItem[] — List of keys to delete.
    - `Key` string, required — The key of the key value pair to be deleted.

## Response `200`

Success

- UpdateKeysResponse — Metadata information about a Key Value Store.
  - `ItemCount` integer, required — Number of key value pairs in the Key Value Store after the successful update.
  - `TotalSizeInBytes` integer, required — Total size of the Key Value Store after the successful update, in bytes.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ServiceQuotaExceededException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/cloudfront-keyvaluestore.md) · [All operations](https://skmtc.net/aws/apis/cloudfront-keyvaluestore/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cloudfront-keyvaluestore/versions/81b65599e9cc/schema)