# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Queries API
  version: 1.0.0
extends: openapi/prisma-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: 4
- target: $.paths['/{apiVersion}/{engineHash}/graphql'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a Prisma Client query through Accelerate
      effect: read
      questions:
      - How do I send a Prisma Client query through the Accelerate proxy?
      - Can Accelerate serve a query result from cache instead of the database?
      instructions:
      - text: Run query {query} through Accelerate on engine {engineHash} and API version {apiVersion}.
        slots:
          query: requestBody.query
          engineHash: path.engineHash
          apiVersion: path.apiVersion
      - text: Execute {query} with variables {variables} via the proxy for engine {engineHash} at {apiVersion}.
        slots:
          query: requestBody.query
          variables: requestBody.variables
          engineHash: path.engineHash
          apiVersion: path.apiVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sessions/{sessionId}/queries'].get
  update:
    x-apievangelist-phrasing:
      intent: List queries captured in a session
      effect: read
      questions:
      - Which queries were captured during my Optimize recording session?
      - Can I sort a session's recorded queries by execution time?
      instructions:
      - text: List the queries recorded in session {sessionId}.
        slots:
          sessionId: path.sessionId
      - text: Show session {sessionId}'s queries sorted by {orderBy} {order}.
        slots:
          sessionId: path.sessionId
          orderBy: query.orderBy
          order: query.order
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sessions/{sessionId}/queries/{queryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get SQL and execution plan for a query
      effect: read
      questions:
      - What SQL and execution plan did one recorded query produce?
      - Where can I see the performance metrics of a single captured query?
      instructions:
      - text: Get details for query {queryId} in session {sessionId}.
        slots:
          queryId: path.queryId
          sessionId: path.sessionId
      - text: Show the full SQL and plan of {queryId} from {sessionId}.
        slots:
          queryId: path.queryId
          sessionId: path.sessionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ingest'].post
  update:
    x-apievangelist-phrasing:
      intent: Send query execution data to Optimize
      effect: write
      questions:
      - What endpoint does the Optimize extension report query data to?
      - Can I push captured query records into a session myself?
      instructions:
      - text: Ingest {queries} into Optimize session {sessionId}.
        slots:
          queries: requestBody.queries
          sessionId: requestBody.sessionId
      - text: Upload execution records {queries} for recording {sessionId}.
        slots:
          queries: requestBody.queries
          sessionId: requestBody.sessionId
      method: generated
      generated: '2026-09-26'