> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erdo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# KV stores

> List and manage keys in shared KV stores.

KV stores are shared organization-level JSON key/value stores. Use the CLI or
API to enumerate keys without guessing them.

```bash theme={null}
erdo kv items pricing
erdo kv items pricing --values --limit 50
```

The response includes each `key` and `updated_at`. `--values` includes the
stored JSON value. For larger stores, pass the response's `next_offset` as
`--offset`; pages are capped at 200 items.

The REST equivalent is `GET /v1/kv/:slug/items?limit=100&offset=0`.

Listing covers the shared keyspace — the same keys `erdo kv get` reads, so every
key it returns reads back. A page that writes per-viewer state with
`erdo.kv.set` keeps those keys private to each signed-in viewer, and they are
not listed here.

`erdo kv list` (`GET /v1/kv`) reports each store's `item_count` over that same
shared keyspace, so the count matches the keys `erdo kv items` enumerates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.