---
title: "Create KV store"
method: POST
path: "/api/kv"
tags: ["KV"]
---

# Create KV store

`POST /api/kv`

Creates a new store with an initial key-value pair and returns a shareable link. Reuse existing owner token to group entities under one owner

## Query parameters

- `ns` string
- `tags` string
- `ttl` string

## Headers

- `X-Password` string
- `X-Owner-Token` string

## Request body

- KvCreateStoreRequest
  - `key` string — Initial key name
  - `value` string — Value for the initial key (max 1 MB)

## Response `201`

Store created

## Other responses

- `400` — Invalid request parameters
- `429` — Rate 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)