KV Storage

​

Start here

• For a focused walk-through of put, get, list, head, and delete, go to KV basic operations.
• For exact method signatures and return types, use the TypeScript declarations shipped with your installed SDK. The Web client overview and Node client overview 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.
• When the account’s storage is full, reads keep working and put returns a failed result with error.code STORAGE_QUOTA_EXCEEDED, or STORAGE_LIMIT_REACHED when one value is larger than the space left. Keep the app usable read-only; see Storage is full.