Skip to main content
KV is a globally distributed key-value store designed for low-latency reads from Telnyx edge functions. Store session data, cache API responses, and manage application state across edge locations.

​
Overview

KV provides:
  • Low-latency reads — Data accessible from edge locations worldwide
  • Simple API — get, put, delete, list operations over HTTP
  • Namespace isolation — Separate key spaces per application
  • Opaque values — A value is stored as the raw bytes you send and returned to you byte-for-byte. You choose the serialization (text, JSON, binary); KV does not transform it
  • Global distribution — No region selection; KV is globally replicated
KV stores values verbatim. It does not base64-encode values, and it has no server-side TTL or per-key metadata today — a value is just bytes. See Key expiration for an application-level expiry pattern.

​
Keys

A key is a path-like string. Allowed characters are a-z, A-Z, 0-9, and - _ / = .. Use / to namespace related keys (for example user/123, session/abc). Colons (:) are not allowed.

​
Consistency Model

KV uses eventual consistency:
  • Writes are immediately visible in the region where they occur
  • Changes propagate globally within seconds
  • Read-after-write consistency is guaranteed within the same region
For use cases requiring strong consistency, consider using SQL DB instead.

​
Next Steps

  • Bindings — Connect to KV and other services
  • SQL DB — Relational database for complex queries
  • Secrets — Secure credential storage