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

object
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 valuesWHITELISTBLACKLISTBOOSTREFERRERFORWARDERAPR
sizeLimitnumberCapped at the caller's quota
publicReadbooleandefault: true

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 '{ "publicRead": true }'
Current params
{
  "body": {
    "publicRead": true
  }
}
Live request — this will call https://api.merkl.xyz/ for real.