# 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 Backups API
  version: 1.0.0
extends: openapi/prisma-database-backups-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['/v1/databases/{databaseId}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a database's backups (v1)
      effect: read
      questions:
      - Can I cap how many backups the v1 API returns for a database?
      - Which backups exist for my database according to the v1 API?
      instructions:
      - text: Get the v1 backup list for database {databaseId}.
        slots:
          databaseId: path.databaseId
      - text: Show the latest {limit} backups of {databaseId}.
        slots:
          limit: query.limit
          databaseId: path.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List automatic and manual backups
      effect: read
      questions:
      - How do I see all automatic and manual backups for a database with their size?
      - What status are my database backups in?
      instructions:
      - text: List automatic and manual backups for database {databaseId}.
        slots:
          databaseId: path.databaseId
      - text: Show backup status and size for {databaseId}.
        slots:
          databaseId: path.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/backups'].post
  update:
    x-apievangelist-phrasing:
      intent: Take a manual database backup
      effect: write
      questions:
      - Can I trigger a manual backup of a database before a risky migration?
      - Is a manual backup created synchronously or in the background?
      instructions:
      - text: Back up database {databaseId} now.
        slots:
          databaseId: path.databaseId
      - text: Create a manual backup of {databaseId} labeled {label}.
        slots:
          databaseId: path.databaseId
          label: requestBody.label
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/backups/{backupId}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a database from a backup
      effect: destructive
      questions:
      - What happens to current data when I restore a database from a backup?
      - How do I roll my database back to a specific backup?
      instructions:
      - text: Restore database {databaseId} from backup {backupId}.
        slots:
          databaseId: path.databaseId
          backupId: path.backupId
      - text: Roll {databaseId} back to the state in backup {backupId}.
        slots:
          databaseId: path.databaseId
          backupId: path.backupId
      method: generated
      generated: '2026-09-26'