---
title: "Creates a key-value."
method: PUT
path: "/kv/{key}"
tags: ["KeyValues"]
---

# Creates a key-value.

`PUT /kv/{key}`

## Path parameters

- `key` string, required

## Query parameters

- `label` string
- `api-version` string, required

## Headers

- `Sync-Token` string
- `If-Match` string
- `If-None-Match` string

## Request body

- KeyValue
  - `key` string — The key of the key-value.
  - `label` string — The label the key-value belongs to.
  - `content_type` string — The content type of the value stored within the key-value.
  - `value` string — The value of the key-value.
  - `last_modified` string, date-time — A date representing the last time the key-value was modified.
  - `tags` object — The tags of the key-value
  - `locked` boolean — Indicates whether the key-value is locked.
  - `etag` string — A value representing the current state of the resource.

## Response `200`

Success

## Other responses

- `default` — Error response describing why the operation failed

---

[API](https://skmtc.dev/azure/apis/appconfiguration-appconfiguration.md) · [All operations](https://skmtc.dev/azure/apis/appconfiguration-appconfiguration/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/appconfiguration-appconfiguration/revisions/cf9d4ff2d253/schema)