# Telnyx Storage: KV — Documentation Index
> KV documentation within the Storage section of the Telnyx developer docs (https://developers.telnyx.com).
> This file: https://developers.telnyx.com/docs/development/llms/storage-kv-llms-txt.md · Root index: https://developers.telnyx.com/llms.txt

## Get Started

- [KV](https://developers.telnyx.com/docs/edge-compute/kv.md): Telnyx KV is globally distributed key-value storage for low-latency reads from edge functions. Use it through the function binding or the REST API.
- [Quick Start](https://developers.telnyx.com/docs/edge-compute/kv/quick-start.md): Create a KV namespace, bind it to your edge function, and read or write data — through the function binding or the REST API.

## Concepts

- [How KV Works](https://developers.telnyx.com/docs/edge-compute/kv/concepts/how-kv-works.md): The Telnyx KV data model: path-like keys, opaque byte values, optional server-side TTL, no per-key metadata, and a single global store with read-your-writes consistency.
- [Key Expiration](https://developers.telnyx.com/docs/edge-compute/kv/ttl-and-metadata.md): Telnyx KV supports server-side TTL — set it when writing through the binding, as a REST parameter, or with a CLI flag — so keys expire automatically.

## Examples

- [Session Storage](https://developers.telnyx.com/docs/edge-compute/kv/examples/session-storage.md): Store user sessions at the edge with Telnyx KV and expire them with a server-side TTL.
- [API Response Caching](https://developers.telnyx.com/docs/edge-compute/kv/examples/api-response-caching.md): Cache expensive upstream API responses at the edge with Telnyx KV and a short server-side TTL.
- [Feature Flags](https://developers.telnyx.com/docs/edge-compute/kv/examples/feature-flags.md): Read feature flags on the request path from Telnyx KV and flip them without redeploying.

## Reference

- [Overview](https://developers.telnyx.com/docs/edge-compute/kv/reference.md): The KV runtime API — the methods available on a bound namespace, plus their option and result types.
- [KvNamespace](https://developers.telnyx.com/docs/edge-compute/kv/reference/kv-namespace.md): The KV binding's runtime API — read, write, delete, and list on a bound namespace, with option and result types and their behavior.
- [CLI](https://developers.telnyx.com/docs/edge-compute/kv/cli.md): Manage Telnyx KV namespaces and keys from your terminal with the CLI — create, list, put, get, and delete.
- [Best Practices](https://developers.telnyx.com/docs/edge-compute/kv/best-practices.md): Practical guidance for Telnyx KV: naming keys, serializing values, and handling missing keys.

## Platform

- [Pricing](https://developers.telnyx.com/docs/edge-compute/kv/pricing.md): Pricing for Telnyx KV: free tier limits and per-million-operation rates for reads, writes, deletes, and lists, with free egress.

## API Reference (KV)

### kv namespaces

- [List KV namespaces](https://developers.telnyx.com/api-reference/kv-namespaces/list-kv-namespaces.md): Lists the KV namespaces for the authenticated user's organization. Results use page-based pagination (`page[number]`/`page[size]`).
- [Create a KV namespace](https://developers.telnyx.com/api-reference/kv-namespaces/create-a-kv-namespace.md): Creates a new KV namespace. Provisioning is asynchronous: the namespace is returned with status `pending` and becomes usable once it reaches `provision_ok`.
- [Get a KV namespace](https://developers.telnyx.com/api-reference/kv-namespaces/get-a-kv-namespace.md): Retrieves a KV namespace by its ID, including its provisioning status.
- [Delete a KV namespace](https://developers.telnyx.com/api-reference/kv-namespaces/delete-a-kv-namespace.md): Deletes a KV namespace and all of the keys it contains. Deletion is asynchronous: the namespace is returned with status `deleting`. Deleting a namespace whose…

### kv keys

- [List keys](https://developers.telnyx.com/api-reference/kv-keys/list-keys.md): Lists the keys in a namespace. Returns key names and metadata only, never values. Results are paginated with `limit` and an opaque `cursor`.
- [Get a key's value](https://developers.telnyx.com/api-reference/kv-keys/get-a-keys-value.md): Returns the raw stored value for a key. The response body is the value exactly as it was written; the `Content-Type` header echoes the value's stored content t…
- [Set a key's value](https://developers.telnyx.com/api-reference/kv-keys/set-a-keys-value.md): Creates or replaces the value for a key. The request body is stored verbatim as the value — no base64, no JSON envelope — up to 1 MiB. The request's `Content-T…
- [Delete a key](https://developers.telnyx.com/api-reference/kv-keys/delete-a-key.md): Deletes a key. Idempotent: deleting a key that does not exist still succeeds. The namespace itself must exist and be provisioned.

### cloudfs filesystems

- [List CloudFS filesystems](https://developers.telnyx.com/api-reference/cloudfs-filesystems/list-cloudfs-filesystems.md): Lists the CloudFS filesystems for the authenticated user's organization. Results use cursor-based pagination: fetch the next page by passing `meta.cursors.afte…
- [Create a CloudFS filesystem](https://developers.telnyx.com/api-reference/cloudfs-filesystems/create-a-cloudfs-filesystem.md): Creates a CloudFS filesystem. Provisioning is synchronous — typically a few seconds, up to a few minutes — and the filesystem is returned with status `ready`,…
- [Get a CloudFS filesystem](https://developers.telnyx.com/api-reference/cloudfs-filesystems/get-a-cloudfs-filesystem.md): Retrieves a CloudFS filesystem by its ID. The returned `meta_url` omits the credential — the metadata token is only ever returned by create and rotate-meta-tok…
- [Update a CloudFS filesystem](https://developers.telnyx.com/api-reference/cloudfs-filesystems/update-a-cloudfs-filesystem.md): Updates a CloudFS filesystem. Only `name` can be changed; other fields are immutable and unknown fields are rejected with a `400`. Renaming to a name that alre…
- [Delete a CloudFS filesystem](https://developers.telnyx.com/api-reference/cloudfs-filesystems/delete-a-cloudfs-filesystem.md): Permanently deletes a CloudFS filesystem, removing its S3 bucket and its metadata database. Deletion is synchronous: the response returns the filesystem's fina…
- [Rotate the metadata token](https://developers.telnyx.com/api-reference/cloudfs-filesystems/rotate-the-metadata-token.md): Issues a new metadata access token for the filesystem and returns the full filesystem, including the new `meta_token` and credential-bearing `meta_url`. The pr…