---
title: "Create a new edge store"
method: POST
path: "/fastedge/v1/kv"
tags: ["Edge Storage"]
---

# Create a new edge store

`POST /fastedge/v1/kv`

Create a new key-value storage store for edge applications.
Stores support multiple data types: simple KV, sorted sets, and bloom filters.

## Request body

- KvStore
  - `name` string, required — A name of the store
  - `comment` string — A description of the store
  - `app_count` integer — The number of applications that use this store
  - `byod` Byod — BYOD (Bring Your Own Data) settings
    - `url` string, required — Connection URL for external storage service (Redis, PostgreSQL, etc.)
    - `prefix` string, required — Key prefix to namespace your data within the external store
  - `size` integer — Total store size in bytes (zero for BYOD stores)
  - `revision` integer — Current store revision (only for non-BYOD stores)
  - `updated_at` string, date-time — Timestamp of last store revision (only for non-BYOD stores)

## Response `200`

Edge store created successfully, returns store metadata with unique ID

- object
  - `name` string, required — A name of the store
  - `comment` string — A description of the store
  - `app_count` integer — The number of applications that use this store
  - `byod` Byod — BYOD (Bring Your Own Data) settings
    - `url` string, required — Connection URL for external storage service (Redis, PostgreSQL, etc.)
    - `prefix` string, required — Key prefix to namespace your data within the external store
  - `size` integer — Total store size in bytes (zero for BYOD stores)
  - `revision` integer — Current store revision (only for non-BYOD stores)
  - `updated_at` string, date-time — Timestamp of last store revision (only for non-BYOD stores)
  - `id` integer — The unique identifier of the store.

## Other responses

- `400` — Bad request
- `503` — Service unavailable

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)