Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt

Use this file to discover all available pages before exploring further.

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
  • Namespace isolation — Separate key spaces per application
  • Binary-safe storage — Store any data type (values are base64-encoded)
  • Global distribution — No region selection; KV is globally replicated
  • TTL support — Auto-expire keys after a specified duration
  • Metadata — Attach JSON metadata to keys for filtering and context

​
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