On this page
Get many in KV
Reads up to 1000 keys at once (MGET).
Reads up to 1000 keys at once (MGET). Answers one entry per key, in order; an absent or expired key keeps its key and has no value.
- Path
POST https://api.data.sylphx.com/v1/kv-mget - Scope
data:read - Effect
read— nothing is written. - Collection kv
- Host
https://api.data.sylphx.com
Request
| Field | Type | What it is |
|---|---|---|
namespace_id | string | The namespace's id. Required. |
keys | string[] | The keys, at most 1000. Required. |
Response
| Field | Type | What it is |
|---|---|---|
values | ValueRecord[] | One entry per key, in the order asked; an absent or expired key keeps its key and has no value or version. |
ValueRecord
| Field | Type | What it is |
|---|---|---|
namespace_id | string | The namespace's id in the environment, for example ratelimit. |
key | string | The key. |
value | bytes | The bytes, base64. |
sha256 | string | sha256:<hex> of the value. |
version | uint64 | The version, increasing per key. |
expires_at_unix_ms | int64 | Expiry in Unix milliseconds; zero never expires. |
updated_at_unix_ms | int64 | When this version was written, in Unix milliseconds. |
Errors
UNAUTHENTICATED— No valid key or token was presented.PERMISSION_DENIED— The key lacks the method's permission.INVALID_FIELD— A field failed validation.RESOURCE_NOT_FOUND— The named Resource does not exist or is not visible.
Every error arrives in the body Errors describes.
Examples
curl -X POST "https://api.data.sylphx.com/v1/kv-mget" \
-H "Authorization: Bearer $SYLPHX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["…"],"namespace_id":"…"}'