TEteam-telnyx
kv keys

List keys

Changed on

Lists the keys in a namespace. Returns key names and metadata only, never values. Results are paginated with limit and an opaque cursor.

get/storage/kvs/{id}/keys

Request

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

Path parameters

idstring uuid required

KV namespace ID

Query parameters

prefixstring

Return only keys that start with this prefix.

limitinteger

Maximum number of keys to return. Values above 1000 are treated as 1000.

cursorstring

Opaque pagination cursor from a previous response's meta.cursor.

Response

Keys retrieved successfully

record_typestring

Example response

{
  "record_type": "storage_kv_key",
  "data": [
    {
      "key": "user/123",
      "size_bytes": 21,
      "updated_at": "2026-06-18T14:48:17Z"
    }
  ]
}

Changes

  • 67df31283a8aRevision changes
    • breaking

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

    • breaking

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

    • breaking

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

    • 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

    • info

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

    • info

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

    • info

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

  • a72569d69430Revision changes
    • info

      endpoint added