Key-Value API
Key-value store
REST API endpoints for Key-Value. 5 operations.
Delete keys
POST /v1/kv/delRemoves one or more keys from the tenant's key-value store (batch delete).
Auth: Bearer API key
Request body
application/json (required) — schema KvDelRequest.
Responses
| Status | Description |
|---|---|
200 | Key deleted |
401 | Missing or invalid API key |
500 | Internal error |
operationId: kvDel
Check if a key exists
POST /v1/kv/existsReturns whether a key is present in the tenant's key-value store.
Auth: Bearer API key
Request body
application/json (required) — schema KvKeyRequest.
Responses
| Status | Description |
|---|---|
200 | { exists: bool } |
401 | Missing or invalid API key |
500 | Internal error |
operationId: kvExists
Fetch a value by key
POST /v1/kv/getReads a single key from the tenant's key-value store; returns value: null if absent.
Auth: Bearer API key
Request body
application/json (required) — schema KvKeyRequest.
Responses
| Status | Description |
|---|---|
200 | The stored value (or value: null if absent) |
401 | Missing or invalid API key |
500 | Internal error |
operationId: kvGet
List keys
POST /v1/kv/keysReturns the keys in the tenant's key-value store matching an optional glob pattern.
Auth: Bearer API key
Request body
application/json (required) — schema KvKeysRequest.
Responses
| Status | Description |
|---|---|
200 | { keys: [string] } matching the pattern |
401 | Missing or invalid API key |
500 | Internal error |
operationId: kvKeys
Set a value by key
POST /v1/kv/setWrites a value to the tenant's key-value store, with an optional TTL.
Auth: Bearer API key
Request body
application/json (required) — schema KvSetRequest.
Responses
| Status | Description |
|---|---|
200 | Value set |
401 | Missing or invalid API key |
500 | Internal error |
operationId: kvSet