Skip to content

Operate on a KV namespace

POST/v1/disks/{disk}/kv/{namespace}
POST
/v1/disks/{disk}/kv/{namespace}
curl --request POST \
--url https://api.wabe.sh/v1/disks/demo/kv/app \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "op": "scan", "prefix": "greet", "limit": 10 }'

Keys: 16 KiB; values: 1 MiB; encoded batches and JSON bodies: 8 MiB. Scan stays within the namespace and uses byte order with an exclusive after cursor sharing the prefix. TTL is unsupported. Mutations never trigger flush; optional remote mode waits for background/explicit persistence.

disk
required
string
/^[A-Za-z0-9_-]{1,128}$/

Example

demo

Project disk name, or the disk ID in the actor runtime disk URL.

namespace
required
string
/^[A-Za-z0-9_-]{1,128}$/

Example

app

Namespace on this disk.

Media typeapplication/json
One of: discriminator: op
object
op
required
Allowed value: get
key
required
One of:

UTF-8 key, at most 16 KiB of encoded bytes. Empty is allowed.

string
<= 16384 characters

Example

{
"op": "scan",
"prefix": "greet",
"limit": 10
}

JSON response for get/exists/put/delete/batch, NDJSON entries for scan. Missing get returns found:false with HTTP 200.

One of:
object
success
required

Invalid input, query, name or source.

Media typetext/plain
string

Missing, invalid or revoked project API key, or an invalid runtime access token.

Media typeapplication/json
object
error
required
string
message
required
string

Actor runtime token does not authorize this disk or instance generation.

Media typeapplication/json
object
error
required
string
message
required
string

Disk not found in this project.

Media typeapplication/json
object
error
required
string
message
required
string

KV size or request-body limit exceeded.

Media typetext/plain
string

KV body requires application/json.

Media typetext/plain
string

KV JSON shape or operation is unsupported.

Media typetext/plain
string

Storage, I/O or corruption failure.

Media typetext/plain
string

Disk unavailable.

Media typeapplication/json
object
error
required
string
message
required
string