# 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 Queries API
  version: 1.0.0
extends: openapi/cloudflare-queries-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: 2
- target: $.paths['/accounts/{account_id}/d1/database/{database_id}/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a SQL query against a D1 database
      effect: write
      questions:
      - How do I run a SQL statement against my D1 database over the API?
      - Can I use bound parameters to avoid SQL injection in D1 queries?
      - Does a D1 query return rows as objects along with execution metadata?
      instructions:
      - text: Run the SQL {sql} on D1 database {database} in account {account}.
        slots:
          sql: requestBody.sql
          database: path.database_id
          account: path.account_id
      - text: Execute {sql} with parameters {params} against D1 database {database}, account {account}, returning rows as objects.
        slots:
          sql: requestBody.sql
          params: requestBody.params
          database: path.database_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accounts/{account_id}/d1/database/{database_id}/raw'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a raw SQL query returning array rows
      effect: write
      questions:
      - Is there a faster D1 query mode that returns rows as arrays instead of objects?
      - How do I get compact array results from a D1 SQL query?
      instructions:
      - text: Run raw SQL {sql} on D1 database {database} in account {account}, returning rows as arrays.
        slots:
          sql: requestBody.sql
          database: path.database_id
          account: path.account_id
      - text: Execute {sql} with parameters {params} in raw array mode on D1 database {database}, account {account}.
        slots:
          sql: requestBody.sql
          params: requestBody.params
          database: path.database_id
          account: path.account_id
      method: generated
      generated: '2026-09-26'