# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Database Usage API
  version: 1.0.0
extends: openapi/prisma-database-usage-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['/v1/databases/{databaseId}/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get database usage metrics (v1)
      effect: read
      questions:
      - Can I pull usage metrics for a database through the v1 API?
      - How do I limit the v1 usage report to a date window?
      instructions:
      - text: Get v1 usage metrics for database {databaseId}.
        slots:
          databaseId: path.databaseId
      - text: Show v1 usage for {databaseId} from {startDate} to {endDate}.
        slots:
          databaseId: path.databaseId
          startDate: query.startDate
          endDate: query.endDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get storage, query and compute usage
      effect: read
      questions:
      - How much storage and compute is my database consuming?
      - What were the query and connection counts for my database last month?
      instructions:
      - text: Report storage, query counts and compute use for database {databaseId}.
        slots:
          databaseId: path.databaseId
      - text: Show connection and query counts for {databaseId} between {startDate} and {endDate}.
        slots:
          databaseId: path.databaseId
          startDate: query.startDate
          endDate: query.endDate
      method: generated
      generated: '2026-09-26'