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

# KV Storage

> Store and retrieve data inside a TinyCloud space

TinyCloud KV is the direct read/write API for data inside a space. Use it when you want JSON, strings, arrays, or binary values stored under a key.

## Start here

* For a focused walk-through of `put`, `get`, `list`, `head`, and `delete`, go to [KV basic operations](/guides/kv/basic-operations).
* For exact method signatures and return types, use the TypeScript declarations shipped with your installed SDK. The [Web client overview](/reference/sdk/web) and [Node client overview](/reference/sdk/node) cover the primary client surfaces.

## What KV is good for

* User profiles
* App state
* Cached objects
* Shared records in a delegated space

## What to keep in mind

* KV values live inside the user's TinyCloud space.
* The same `tc.kv` surface exists in both SDKs.
* Space naming and key naming are separate concerns.

<Note>
  Verified against the KV service shipped with TinyCloud SDK 2.7.0.
</Note>