Inserts or updates a value for the given key (upsert semantics). The optional `ttl` query parameter sets an expiry in seconds; omitting it stores the key indefinitely. `If-Match` (an ETag from a prior read) or `If-None-Match: *` (create only) make the write conditional; without them the last writer wins.

PUT

/store-api/kv/{domain}/keys/{key}

curl --request PUT \
  --url https://example.com/store-api/kv/example/keys/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: text/plain' \
  --data example

Authorizations

• bearer_auth

Parameters

Path Parameters

domain

required

string

Domain name

key

required

string

Key (valid UTF-8, max 256 bytes)

Query Parameters

ttl

integer format: int64

TTL in seconds (optional)

Header Parameters

If-Match

string | null

ETag from a prior read: write only if it is still the key’s current version, else 412

If-None-Match

string | null

Only *: write only if the key does not exist, else 412. Evaluated after If-Match

Request Body^required

Media typetext/plain

string

Responses

200

Key upserted

400

Invalid key, or invalid If-Match / If-None-Match header

Media typetext/plain

string

404

Domain not found

Media typetext/plain

string

410

Domain is being deleted

Media typetext/plain

string

412

If-Match or If-None-Match does not hold; nothing was written

Media typetext/plain

string

Headers

ETag

string

ETag of the key’s current version; absent when the key does not exist

428

The domain requires conditional writes and neither If-Match nor If-None-Match is set

Media typetext/plain

string

Headers

Cache-Control

string

No-store

429

Rate limit exceeded

Media typetext/plain

string

Headers

Retry-After

integer format: int64

507

Insufficient Storage — disk space or memory runs short; the write was not applied. Reads go on; retry after the seconds in Retry-After.

Media typetext/plain

string

Headers

Retry-After

integer