Skip to content

API - KV

Key-value operations for storing and retrieving config and secrets.

Set Value

PUT /v1/kv/{namespace}/{key}

Request body:

json
{
  "value": "localhost",
  "type": "config"
}
FieldTypeDescription
valuestringThe value to store
typestring"config" or "secret"

Example:

bash
curl -X PUT http://localhost:7200/v1/kv/myapp/prod/DB_HOST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value":"localhost","type":"config"}'

Get Value

GET /v1/kv/{namespace}/{key}
bash
curl http://localhost:7200/v1/kv/myapp/prod/DB_HOST \
  -H "Authorization: Bearer YOUR_TOKEN"

Get Specific Version

GET /v1/kv/{namespace}/{key}?version={n}
bash
curl "http://localhost:7200/v1/kv/myapp/prod/DB_HOST?version=2" \
  -H "Authorization: Bearer YOUR_TOKEN"

List Versions

GET /v1/kv/{namespace}/{key}/versions
bash
curl http://localhost:7200/v1/kv/myapp/prod/DB_HOST/versions \
  -H "Authorization: Bearer YOUR_TOKEN"

List Keys in Namespace

GET /v1/kv/{namespace}
bash
curl http://localhost:7200/v1/kv/myapp/prod \
  -H "Authorization: Bearer YOUR_TOKEN"

Delete Key

DELETE /v1/kv/{namespace}/{key}
bash
curl -X DELETE http://localhost:7200/v1/kv/myapp/prod/DB_HOST \
  -H "Authorization: Bearer YOUR_TOKEN"

Apache License 2.0