post

/v4/key-value-stores/self

Create a key-value store you own (allowlisted users, X-API-Key). key is a suffix; the response returns the canonical, owner-namespaced key used for entry writes, update and delete.

Request body

keystring

required

Unique human-readable key (alphanumeric, hyphens, underscores). Server-namespaced per owner.

descriptionstring

typeenum

required

Semantic type — determines the required JSON shape of entry values

sizeLimitnumber

Capped at the caller's quota

publicReadbooleandefault: true

truefalse

Responses

200

Response for status 200

Schema

object

idstring

required

keystring

required

descriptionstring | null

required

accessModestring

required

typestring

required

sizeLimitnumber

required

publicReadboolean

required

ownerAddressstring

required

createdAtstring

required

updatedAtstring

required

Example

{
  "id": "string",
  "key": "string",
  "description": "string",
  "accessMode": "string",
  "type": "string",
  "sizeLimit": 0,
  "publicRead": false,
  "ownerAddress": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

post

https://api.merkl.xyz/v4/key-value-stores/self

Merkl API

curl -X POST "https://api.merkl.xyz/v4/key-value-stores/self" \
  -H "Content-Type: application/json" \
  -d '{ "key": "my-store", "type": "WHITELIST", "publicRead": true }'

Live request: this will call https://api.merkl.xyz/ for real.