Cloudflare · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cloudflare KV Bulk Operations API

4 actions 4 updates phrasing extends openapi/cloudflare-bulk-operations-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Cloudflare's API. It is a proposal applied on top of the contract, not a document Cloudflare publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info
$.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk'].put
$.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/delete'].post
$.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/get'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cloudflare KV Bulk Operations API
  version: 1.0.0
extends: openapi/cloudflare-bulk-operations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk'].put
  update:
    x-apievangelist-phrasing:
      intent: Write many KV pairs in one request
      effect: write
      questions:
      - How do I load thousands of keys into a KV namespace at once?
      - What's the maximum number of key-value pairs I can bulk write in a single call?
      instructions:
      - text: Bulk write a set of key-value pairs into namespace {namespace} in account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      - text: Upload up to 10,000 KV entries in one request to namespace {namespace} on account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete many KV pairs in one request
      effect: destructive
      questions:
      - Can I delete a whole list of KV keys in a single request?
      - How do I clear out many keys from a namespace without deleting them one at a time?
      instructions:
      - text: Bulk delete a list of keys from KV namespace {namespace} in account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      - text: Remove multiple key-value pairs at once from namespace {namespace} on account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/storage/kv/namespaces/{namespace_id}/bulk/get'].post
  update:
    x-apievangelist-phrasing:
      intent: Read many KV pairs in one request
      effect: read
      questions:
      - Is there a way to fetch the values of several KV keys in one call?
      - How do I batch-read multiple keys from a namespace?
      instructions:
      - text: Bulk read several keys from KV namespace {namespace} in account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      - text: Fetch multiple key-value pairs together from namespace {namespace} on account {account}.
        slots:
          namespace: path.namespace_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'