---
title: "Upsert key"
method: PUT
path: "/api/kv/{ns}/{id}/{key}"
tags: ["KV"]
---

# Upsert key

`PUT /api/kv/{ns}/{id}/{key}`

Creates or updates a key in the store; max 1000 keys per store

## Path parameters

- `ns` string, required
- `id` string, required
- `key` string, required

## Headers

- `X-Owner-Token` string, required

## Request body

- KvUpsertKeyRequest
  - `value` string — New value for the key (max 1 MB)

## Response `200`

Key upserted

## Other responses

- `403` — Missing or wrong owner token
- `404` — Store not found or expired
- `409` — Key limit exceeded

---

[API](https://skmtc.net/brewpage/apis/brewpage-api.md) · [All operations](https://skmtc.net/brewpage/apis/brewpage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brewpage/brewpage-api/revisions/6e0ac03e39e5/schema)