# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cloudflare D1 Databases API
  version: 1.0.0
extends: openapi/cloudflare-databases-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: 5
- target: $.paths['/accounts/{account_id}/d1/database'].get
  update:
    x-apievangelist-phrasing:
      intent: List D1 databases in an account
      effect: read
      questions:
      - What D1 databases do I have in my account?
      - Can I find a D1 database by its name instead of scrolling through all of them?
      instructions:
      - text: List all D1 databases in account {account}.
        slots:
          account: path.account_id
      - text: Find D1 databases in account {account} named {name}.
        slots:
          account: path.account_id
          name: query.name
      - text: Show page {page} of D1 databases in account {account}, {per_page} per page.
        slots:
          page: query.page
          account: path.account_id
          per_page: query.per_page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/d1/database'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new D1 SQL database
      effect: write
      questions:
      - How do I spin up a new serverless SQL database on Cloudflare?
      - Can I choose which region a new D1 database's primary lives in?
      instructions:
      - text: Create a D1 database named {name} in account {account}.
        slots:
          name: requestBody.name
          account: path.account_id
      - text: Create D1 database {name} in account {account} with its primary near {primary_location_hint}.
        slots:
          name: requestBody.name
          account: path.account_id
          primary_location_hint: requestBody.primary_location_hint
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/d1/database/{database_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a D1 database
      effect: read
      questions:
      - How do I look up the details of one specific D1 database?
      - Where can I check the configuration of a D1 database by its ID?
      instructions:
      - text: Show details for D1 database {database} in account {account}.
        slots:
          database: path.database_id
          account: path.account_id
      - text: Get the configuration of D1 database {database} in account {account}.
        slots:
          database: path.database_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/d1/database/{database_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or reconfigure a D1 database
      effect: write
      questions:
      - Can I rename a D1 database after creating it?
      - How do I change the configuration of an existing D1 database?
      instructions:
      - text: Rename D1 database {database} in account {account} to {name}.
        slots:
          database: path.database_id
          account: path.account_id
          name: requestBody.name
      - text: Update the settings of existing D1 database {database} in account {account}.
        slots:
          database: path.database_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/d1/database/{database_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a D1 database and its data
      effect: destructive
      questions:
      - How do I permanently delete a D1 database?
      - Does deleting a D1 database also wipe all the tables and rows in it?
      instructions:
      - text: Delete D1 database {database} from account {account}.
        slots:
          database: path.database_id
          account: path.account_id
      - text: Drop D1 database {database} in account {account} along with all its contents.
        slots:
          database: path.database_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'