kv namespaces

List KV namespaces

Changed on

Lists the KV namespaces for the authenticated user's organization. Results use page-based pagination (page[number]/page[size]).

get/storage/kvs

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/storage/kvs
  • Auth: HTTP bearer

Query parameters

page[number]integer

The page number to load.

page[size]integer

The size of the page. Values above 250 are treated as 250.

Response

KV namespaces retrieved successfully

Example response

{
  "data": [
    {
      "record_type": "storage_kv",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "my-cache",
      "status": "provision_ok",
      "created_at": "2026-06-18T14:48:17Z",
      "updated_at": "2026-06-18T14:48:17Z"
    }
  ],
  "meta": {
    "page_number": 1,
    "page_size": 20,
    "total_pages": 3,
    "total_results": 52
  }
}

Changes

  • 19db5ee4ec59Revision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

  • a6a61a29ecddRevision changes
    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • warning

      removed the optional property /// from the response with the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status