Skip to content
v0.5.1GitHub

Using

Lists one page of keys in the domain, optionally filtered by a prefix and/or a case-sensitive `contains` substring. `total` counts matches after filtering, before `offset`/`limit` are applied; an out-of-range `offset` yields an empty `keys` array with `total` unchanged.

applies to v0.5.1
GET
/store-api/kv/{domain}/keys
curl --request GET \
--url https://example.com/store-api/kv/example/keys \
--header 'Authorization: Bearer <token>'
domain
required
string

Domain name

prefix
string

Key prefix filter

contains
string

Case-sensitive substring filter on the user key, applied before total/offset/limit

limit
integer

Page size (default 1000, max 10000; over-max is silently capped)

offset
integer

Keys to skip

One page of matching keys

Media typeapplication/json
object
keys
required

The page, in scan order (sorted).

Array<string>
limit
required

Effective limit applied (after capping to the maximum).

integer
offset
required

Effective offset applied.

integer
total
required

Matches after prefix/contains filtering, before offset/limit.

integer format: int64

Example generated

{
"keys": [
"example"
],
"limit": 1,
"offset": 1,
"total": 1
}

Domain is being deleted

Media typetext/plain
string

Rate limit exceeded

Media typetext/plain
string
Retry-After
integer format: int64