KV Store

Attach custom string data to your profile. It appears under kv in your presence and pushes a realtime update over the socket on change.

Endpoints

PUT    /v1/users/:id/kv/:key     # set one key (value = request body)
PATCH  /v1/users/:id/kv          # merge a JSON object of pairs
DELETE /v1/users/:id/kv/:key     # delete one key

All KV writes require your Authorization header.

curl -X PUT https://api.zruvix.com/v1/users/<id>/kv/location \
  -H "Authorization: <your_api_key>" \
  -d "Tokyo"

Merge multiple keys at once:

curl -X PATCH https://api.zruvix.com/v1/users/<id>/kv \
  -H "Authorization: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{ "location": "Tokyo", "mood": "focused" }'

Limits

Keys are alphanumeric/underscore, up to 255 chars.
Values up to 30,000 chars.
Up to 512 keys per user.

API keys

DM the bot ?apikey to receive your secret key. Send it in the Authorization header for KV writes and /@me.

Keep it private

Anyone with your API key can edit your data. Treat it like a password and rotate it via the bot if it leaks.

KV Store

Endpoints

Limits

API keys

On this page