Cloudflare · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cloudflare Accounts API

741 actions 741 updates phrasing extends openapi/cloudflare-accounts-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 741 · first 16 shown; the file carries all of them

$.info
$.paths['/accounts'].get
$.paths['/accounts/{account_id}'].get
$.paths['/accounts/{account_id}'].put
$.paths['/accounts/{account_id}/addressing/address_maps'].get
$.paths['/accounts/{account_id}/addressing/address_maps'].post
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].get
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].delete
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].patch
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}'].put
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}'].delete
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}'].put
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}'].delete
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}'].put
$.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}'].delete
$.paths['/accounts/{account_id}/addressing/loa_documents'].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 Accounts API
  version: 1.0.0
extends: openapi/cloudflare-accounts-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: 740
- target: $.paths['/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List the accounts I can access
      effect: read
      questions:
      - Which Cloudflare accounts do I own or have verified access to?
      - Can I look up one of my accounts by its name?
      instructions:
      - text: List every account I have access to.
      - text: Find my accounts named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account's details
      effect: read
      questions:
      - What information is stored about a specific account I belong to?
      - Where can I see the settings and creation date of one account?
      instructions:
      - text: Show the details of account {account_id}.
        slots:
          account_id: path.account_id
      - text: Pull up the settings recorded for account {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or reconfigure an account
      effect: write
      questions:
      - How do I rename an existing account?
      - Can I change an account's settings after it is created?
      instructions:
      - text: Rename account {account_id} to {name}.
        slots:
          account_id: path.account_id
          name: requestBody.name
      - text: Update the settings of account {account_id} to {settings}.
        slots:
          account_id: path.account_id
          settings: requestBody.settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps'].get
  update:
    x-apievangelist-phrasing:
      intent: List an account's address maps
      effect: read
      questions:
      - Which address maps does my account own?
      - Can I see all the IP address maps configured for my BYOIP setup?
      instructions:
      - text: List the address maps in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show me every address map we own.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an address map
      effect: write
      questions:
      - How do I create a new address map for my IPs?
      - Can a new address map start out disabled?
      instructions:
      - text: Create an address map in account {account_id} described as {description}.
        slots:
          account_id: path.account_id
          description: requestBody.description
      - text: Set up a new address map with enabled set to {enabled}.
        slots:
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one address map
      effect: read
      questions:
      - What IPs, zones and settings are on a particular address map?
      - Is a given address map currently enabled?
      instructions:
      - text: Show address map {address_map_id} in account {account_id}.
        slots:
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Get the details of address map {address_map_id}.
        slots:
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an address map
      effect: destructive
      questions:
      - How do I delete an address map I no longer need?
      - Does an address map have to be disabled before it can be deleted?
      instructions:
      - text: Delete address map {address_map_id} from account {account_id}.
        slots:
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Remove the disabled address map {address_map_id}.
        slots:
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an address map
      effect: write
      questions:
      - Can I change the default SNI on an existing address map?
      - How do I disable an address map without deleting it?
      instructions:
      - text: Set the default SNI of address map {address_map_id} in account {account_id} to {default_sni}.
        slots:
          address_map_id: path.address_map_id
          account_id: path.account_id
          default_sni: requestBody.default_sni
      - text: Change address map {address_map_id} enabled status to {enabled}.
        slots:
          address_map_id: path.address_map_id
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add an account to an address map
      effect: write
      questions:
      - How do I make an account a member of an address map?
      - Can an address map apply to a whole account instead of individual zones?
      instructions:
      - text: Add account {account_id} as a member of address map {address_map_id}.
        slots:
          account_id: path.account_id
          address_map_id: path.address_map_id
      - text: Attach the account membership to address map {address_map_id}.
        slots:
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an account from an address map
      effect: destructive
      questions:
      - How do I take an account out of an address map's membership?
      - What happens when I drop the account membership from an address map?
      instructions:
      - text: Remove account {account_id} from address map {address_map_id}.
        slots:
          account_id: path.account_id
          address_map_id: path.address_map_id
      - text: Drop the account membership on address map {address_map_id}.
        slots:
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add an IP to an address map
      effect: write
      questions:
      - How do I add one of my prefix IPs to an address map?
      - Does the IP I add to an address map need to come from a prefix my account owns?
      instructions:
      - text: Add IP {ip_address} to address map {address_map_id} in account {account_id}.
        slots:
          ip_address: path.ip_address
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Put {ip_address} on address map {address_map_id}.
        slots:
          ip_address: path.ip_address
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an IP from an address map
      effect: destructive
      questions:
      - How do I take a single IP off an address map?
      - Can I pull one address out of a map without deleting the map?
      instructions:
      - text: Remove IP {ip_address} from address map {address_map_id} in account {account_id}.
        slots:
          ip_address: path.ip_address
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Take {ip_address} off address map {address_map_id}.
        slots:
          ip_address: path.ip_address
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a zone to an address map
      effect: write
      questions:
      - How do I make a zone a member of an address map?
      - Can I scope an address map to specific zones?
      instructions:
      - text: Add zone {zone_id} to address map {address_map_id} in account {account_id}.
        slots:
          zone_id: path.zone_id
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Make zone {zone_id} a member of address map {address_map_id}.
        slots:
          zone_id: path.zone_id
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a zone from an address map
      effect: destructive
      questions:
      - How do I remove a zone from an address map?
      - Can a zone stop using an address map without the map being deleted?
      instructions:
      - text: Remove zone {zone_id} from address map {address_map_id} in account {account_id}.
        slots:
          zone_id: path.zone_id
          address_map_id: path.address_map_id
          account_id: path.account_id
      - text: Drop zone {zone_id}'s membership in address map {address_map_id}.
        slots:
          zone_id: path.zone_id
          address_map_id: path.address_map_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/loa_documents'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a Letter of Authorization
      effect: write
      questions:
      - How do I submit an LOA document for my IP prefix?
      - What file format does the Letter of Authorization upload expect?
      instructions:
      - text: Upload LOA PDF {loa_document} to account {account_id}.
        slots:
          loa_document: requestBody.loa_document
          account_id: path.account_id
      - text: Submit {loa_document} as our Letter of Authorization.
        slots:
          loa_document: requestBody.loa_document
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/loa_documents/{loa_document_id}/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a Letter of Authorization
      effect: read
      questions:
      - Can I download an LOA document I already uploaded?
      - Where do I get a copy of the Letter of Authorization on file for my account?
      instructions:
      - text: Download LOA document {loa_document_id} from account {account_id}.
        slots:
          loa_document_id: path.loa_document_id
          account_id: path.account_id
      - text: Fetch the PDF of LOA {loa_document_id}.
        slots:
          loa_document_id: path.loa_document_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes'].get
  update:
    x-apievangelist-phrasing:
      intent: List my IP prefixes
      effect: read
      questions:
      - Which IP prefixes has my account brought to Cloudflare?
      - Can I see every BYOIP prefix we own in one list?
      instructions:
      - text: List all IP prefixes in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show me our onboarded BYOIP prefixes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard a new IP prefix
      effect: write
      questions:
      - How do I bring my own IP range to the account?
      - What do I need, such as an ASN and LOA, to add a new prefix?
      instructions:
      - text: Add prefix {cidr} with ASN {asn} and LOA {loa_document_id} to account {account_id}.
        slots:
          cidr: requestBody.cidr
          asn: requestBody.asn
          loa_document_id: requestBody.loa_document_id
          account_id: path.account_id
      - text: Onboard CIDR {cidr} announced from ASN {asn}.
        slots:
          cidr: requestBody.cidr
          asn: requestBody.asn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one IP prefix
      effect: read
      questions:
      - What is the approval status and ASN of a particular prefix?
      - Can I look up a single prefix by its ID?
      instructions:
      - text: Show prefix {prefix_id} in account {account_id}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Get the details of IP prefix {prefix_id}.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an unapproved prefix
      effect: destructive
      questions:
      - Can I delete a prefix that has not been approved yet?
      - How do I withdraw a prefix submission I made by mistake?
      instructions:
      - text: Delete unapproved prefix {prefix_id} from account {account_id}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Remove pending prefix {prefix_id}.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a prefix's description
      effect: write
      questions:
      - Can I relabel an IP prefix with a better description?
      - Is the description the only thing I can edit on a prefix?
      instructions:
      - text: Set the description of prefix {prefix_id} in account {account_id} to {description}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
          description: requestBody.description
      - text: Relabel prefix {prefix_id} as {description}.
        slots:
          prefix_id: path.prefix_id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bgp/prefixes'].get
  update:
    x-apievangelist-phrasing:
      intent: List BGP prefixes within an IP prefix
      effect: read
      questions:
      - Which subnets of my IP prefix are set up as BGP prefixes?
      - How can I see what parts of a prefix can be advertised to the Internet?
      instructions:
      - text: List the BGP prefixes under prefix {prefix_id} in account {account_id}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Show the advertisable subnets inside prefix {prefix_id}.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bgp/prefixes/{bgp_prefix_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one BGP prefix
      effect: read
      questions:
      - Is a specific BGP prefix currently advertised or withdrawn?
      - Can I look up a single BGP subnet by its ID?
      instructions:
      - text: Get BGP prefix {bgp_prefix_id} of prefix {prefix_id} in account {account_id}.
        slots:
          bgp_prefix_id: path.bgp_prefix_id
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Show the on-demand state of BGP prefix {bgp_prefix_id}.
        slots:
          bgp_prefix_id: path.bgp_prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bgp/prefixes/{bgp_prefix_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Advertise or withdraw a BGP subnet
      effect: write
      questions:
      - How do I advertise just one subnet of my prefix on demand?
      - Can I withdraw a single BGP prefix while leaving the rest advertised?
      instructions:
      - text: Set on-demand advertisement of BGP prefix {bgp_prefix_id} under prefix {prefix_id} in account {account_id} to {on_demand}.
        slots:
          bgp_prefix_id: path.bgp_prefix_id
          prefix_id: path.prefix_id
          account_id: path.account_id
          on_demand: requestBody.on_demand
      - text: Withdraw the BGP subnet {bgp_prefix_id}.
        slots:
          bgp_prefix_id: path.bgp_prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bgp/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a prefix's advertisement status
      effect: read
      questions:
      - Is my whole IP prefix being advertised over BGP right now?
      - When did a prefix's advertisement state last change?
      instructions:
      - text: Check whether prefix {prefix_id} in account {account_id} is advertised.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Get the dynamic advertisement status of prefix {prefix_id}.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bgp/status'].patch
  update:
    x-apievangelist-phrasing:
      intent: Advertise or withdraw a whole prefix
      effect: write
      questions:
      - How do I start advertising my entire prefix during an attack?
      - Can I withdraw the BGP route for a whole prefix?
      instructions:
      - text: Set advertised to {advertised} for prefix {prefix_id} in account {account_id}.
        slots:
          advertised: requestBody.advertised
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Withdraw the BGP route for the entire prefix {prefix_id} by setting advertised to {advertised}.
        slots:
          prefix_id: path.prefix_id
          advertised: requestBody.advertised
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List a prefix's service bindings
      effect: read
      questions:
      - Which Cloudflare services is my IP prefix bound to?
      - Where does traffic to my prefix get routed on the network?
      instructions:
      - text: List service bindings on prefix {prefix_id} in account {account_id}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Show which services prefix {prefix_id} routes to.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bindings'].post
  update:
    x-apievangelist-phrasing:
      intent: Bind a prefix range to a service
      effect: write
      questions:
      - How do I route traffic for part of my prefix to a Cloudflare service?
      - Can I bind a smaller CIDR inside my prefix to Magic Transit or CDN?
      instructions:
      - text: Bind {cidr} in prefix {prefix_id} of account {account_id} to service {service_id}.
        slots:
          cidr: requestBody.cidr
          prefix_id: path.prefix_id
          account_id: path.account_id
          service_id: requestBody.service_id
      - text: Create a service binding routing {cidr} to service {service_id}.
        slots:
          cidr: requestBody.cidr
          service_id: requestBody.service_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bindings/{binding_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one service binding
      effect: read
      questions:
      - What CIDR and service does a particular binding cover?
      - Is a service binding still being provisioned?
      instructions:
      - text: Show service binding {binding_id} on prefix {prefix_id} in account {account_id}.
        slots:
          binding_id: path.binding_id
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Fetch binding {binding_id}.
        slots:
          binding_id: path.binding_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/bindings/{binding_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a service binding
      effect: destructive
      questions:
      - How do I stop routing a CIDR to a Cloudflare service?
      - Can I remove a single binding from my prefix?
      instructions:
      - text: Delete service binding {binding_id} on prefix {prefix_id} in account {account_id}.
        slots:
          binding_id: path.binding_id
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Unbind {binding_id} from its service.
        slots:
          binding_id: path.binding_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/delegations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a prefix's delegations
      effect: read
      questions:
      - Which other accounts have I delegated parts of my prefix to?
      - Can I see all delegations for one IP prefix?
      instructions:
      - text: List delegations of prefix {prefix_id} in account {account_id}.
        slots:
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Show who prefix {prefix_id} is delegated to.
        slots:
          prefix_id: path.prefix_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/delegations'].post
  update:
    x-apievangelist-phrasing:
      intent: Delegate part of a prefix to another account
      effect: write
      questions:
      - How do I let another account use a CIDR from my prefix?
      - Can I delegate a subnet of my BYOIP range to a different account?
      instructions:
      - text: Delegate {cidr} from prefix {prefix_id} in account {account_id} to account {delegated_account_id}.
        slots:
          cidr: requestBody.cidr
          prefix_id: path.prefix_id
          account_id: path.account_id
          delegated_account_id: requestBody.delegated_account_id
      - text: Share subnet {cidr} with account {delegated_account_id}.
        slots:
          cidr: requestBody.cidr
          delegated_account_id: requestBody.delegated_account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/prefixes/{prefix_id}/delegations/{delegation_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a prefix delegation
      effect: destructive
      questions:
      - How do I take back a CIDR I delegated to another account?
      - Can I delete one delegation without affecting the prefix?
      instructions:
      - text: Delete delegation {delegation_id} on prefix {prefix_id} in account {account_id}.
        slots:
          delegation_id: path.delegation_id
          prefix_id: path.prefix_id
          account_id: path.account_id
      - text: Revoke prefix delegation {delegation_id}.
        slots:
          delegation_id: path.delegation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/addressing/services'].get
  update:
    x-apievangelist-phrasing:
      intent: List services a BYOIP prefix can bind to
      effect: read
      questions:
      - What Cloudflare services can my onboarded prefix be bound to?
      - Where do I find the service IDs needed to create a binding?
      instructions:
      - text: List the bindable services available to account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show the service IDs I can use for prefix bindings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/baai/bge-base-en-v1.5'].post
  update:
    x-apievangelist-phrasing:
      intent: Embed text with @cf bge-base-en-v1.5
      effect: write
      questions:
      - Can I generate English text embeddings with the @cf/baai/bge-base-en-v1.5 model?
      - Which mid-sized BGE embedding model runs under the @cf namespace?
      instructions:
      - text: Embed {text} using @cf/baai/bge-base-en-v1.5 in account {account_id}.
        slots:
          text: requestBody.text
          account_id: path.account_id
      - text: Get base-size @cf BGE vectors for {text}.
        slots:
          text: requestBody.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/baai/bge-large-en-v1.5'].post
  update:
    x-apievangelist-phrasing:
      intent: Embed text with bge-large-en-v1.5
      effect: write
      questions:
      - Is there a large BGE model for higher quality English embeddings?
      - How would I vectorize documents with @cf/baai/bge-large-en-v1.5?
      instructions:
      - text: Create large BGE embeddings for {text} in account {account_id}.
        slots:
          text: requestBody.text
          account_id: path.account_id
      - text: Run bge-large-en-v1.5 on {text}.
        slots:
          text: requestBody.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/baai/bge-small-en-v1.5'].post
  update:
    x-apievangelist-phrasing:
      intent: Embed text with bge-small-en-v1.5
      effect: write
      questions:
      - What's the smallest, fastest BGE embedding model I can call?
      - Can I get compact 384-style small embeddings from @cf/baai/bge-small-en-v1.5?
      instructions:
      - text: Embed {text} with the small BGE model in account {account_id}.
        slots:
          text: requestBody.text
          account_id: path.account_id
      - text: Run bge-small-en-v1.5 over {text} for lightweight vectors.
        slots:
          text: requestBody.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/bytedance/stable-diffusion-xl-lightning'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an image with SDXL Lightning
      effect: write
      questions:
      - Can I generate images quickly from a prompt with stable-diffusion-xl-lightning?
      - Does the SDXL Lightning endpoint let me set the number of steps?
      instructions:
      - text: Generate an SDXL Lightning image of {prompt} in account {account_id}.
        slots:
          prompt: requestBody.prompt
          account_id: path.account_id
      - text: Make a fast bytedance lightning image of {prompt} in {num_steps} steps.
        slots:
          prompt: requestBody.prompt
          num_steps: requestBody.num_steps
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/deepseek-ai/deepseek-math-7b-base'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the deepseek-math-7b-base model
      effect: write
      questions:
      - Can I call the base (non-instruct) deepseek-math 7B model?
      - Which endpoint runs deepseek-math-7b-base for raw math completion?
      instructions:
      - text: Run deepseek-math-7b-base in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Complete this math text with the base deepseek-math model.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/deepseek-ai/deepseek-math-7b-instruct'].post
  update:
    x-apievangelist-phrasing:
      intent: Run deepseek-math-7b-instruct
      effect: write
      questions:
      - Can an instruct-tuned model solve math word problems for me?
      - Where do I call @cf/deepseek-ai/deepseek-math-7b-instruct?
      instructions:
      - text: Ask deepseek-math-7b-instruct to solve a problem in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Use the instruct deepseek math model to work through this equation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/defog/sqlcoder-7b-2'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate SQL with sqlcoder-7b-2
      effect: write
      questions:
      - Is there a model that turns natural language questions into SQL?
      - Can I run defog sqlcoder-7b-2 on Workers AI?
      instructions:
      - text: Run sqlcoder-7b-2 in account {account_id} to write a SQL query.
        slots:
          account_id: path.account_id
      - text: Translate my question into SQL with the defog sqlcoder model.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/facebook/bart-large-cnn'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize text with bart-large-cnn
      effect: write
      questions:
      - Can I summarize a long article with a model call?
      - Is there a way to cap the length of a bart-large-cnn summary?
      instructions:
      - text: Summarize {input_text} with bart-large-cnn in account {account_id}.
        slots:
          input_text: requestBody.input_text
          account_id: path.account_id
      - text: Condense {input_text} into at most {max_length} tokens.
        slots:
          input_text: requestBody.input_text
          max_length: requestBody.max_length
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/facebook/detr-resnet-50'].post
  update:
    x-apievangelist-phrasing:
      intent: Detect objects with detr-resnet-50
      effect: write
      questions:
      - Can I detect and locate objects in a photo with an AI model?
      - Which model returns bounding boxes for objects in an image?
      instructions:
      - text: Run detr-resnet-50 object detection in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Find the objects and their boxes in this image with DETR.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/ai/run/@cf/huggingface/distilbert-sst-2-int8'].post
  update:
    x-apievangelist-phrasing:
      intent: Classify sentiment with distilbert-sst-2
      effect: write
      questions:
      - Can I tell whether a sentence is positive or negative?
      - Which model scores sentiment on short text?
      instructions:
      - text: Score the sentiment of {text} with distilbert-sst-2-int8 in account {account_id}.
        slots:
          text: requestBody.text
          account_id: path.account_id
      - text: Classify {text} as positive or negative.
        slots:
          text: requestBody.text
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (518 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cloudflare/refs/heads/main/overlays/cloudflare-accounts-api-phrasing-overlay.yaml