# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Connections API
  version: 1.0.0
extends: openapi/prisma-connections-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: 8
- target: $.paths['/v1/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List connections I have access to
      effect: read
      questions:
      - Which database connections can my token see across all databases?
      - Can I filter the v1 connection list down to one database?
      instructions:
      - text: List all my connections.
      - text: Page through my v1 connections filtered to database {databaseId}.
        slots:
          databaseId: query.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/connections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a named connection for a database
      effect: write
      questions:
      - How do I create a named connection for a database with the v1 API?
      - What do I need to supply to add a connection to a database?
      instructions:
      - text: Create a connection named {name} for database {databaseId}.
        slots:
          name: requestBody.name
          databaseId: requestBody.databaseId
      - text: Add connection {name} to {databaseId} through the v1 connections endpoint.
        slots:
          name: requestBody.name
          databaseId: requestBody.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/connections/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connection by ID
      effect: read
      questions:
      - How do I look up one connection by its ID?
      - What does the v1 API return for a single connection?
      instructions:
      - text: Get connection {id}.
        slots:
          id: path.id
      - text: Show me the details of connection {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/connections/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connection
      effect: destructive
      questions:
      - Can I delete a connection by ID with the v1 API?
      - Is removing a v1 connection reversible?
      instructions:
      - text: Delete connection {id}.
        slots:
          id: path.id
      - text: Remove connection {id} via the v1 connections endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/connections/{id}/rotate'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate a connection's credentials
      effect: write
      questions:
      - How do I rotate credentials for a database connection?
      - Are the old credentials revoked immediately when I rotate them?
      instructions:
      - text: Rotate the credentials for connection {id}.
        slots:
          id: path.id
      - text: Generate fresh credentials for {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List a database's connection strings
      effect: read
      questions:
      - Where can I find the direct TCP connection details for a database?
      - Can I see the Prisma Postgres connection string for one database?
      instructions:
      - text: List connection strings for database {databaseId}.
        slots:
          databaseId: path.databaseId
      - text: Show the Prisma Postgres and direct TCP connection strings for {databaseId}.
        slots:
          databaseId: path.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/databases/{databaseId}/connections'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a connection string for a database
      effect: write
      questions:
      - How do I generate a pooled connection string for a database?
      - What connection types can I pick when generating a connection string?
      instructions:
      - text: Generate a {type} connection string for database {databaseId}.
        slots:
          type: requestBody.type
          databaseId: path.databaseId
      - text: Create a {type} connection string called {name} on {databaseId}.
        slots:
          type: requestBody.type
          name: requestBody.name
          databaseId: path.databaseId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/connections/{connectionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a database connection string
      effect: destructive
      questions:
      - Do clients lose database access as soon as a connection string is deleted?
      - How can I revoke a connection string that was exposed?
      instructions:
      - text: Revoke connection string {connectionId}.
        slots:
          connectionId: path.connectionId
      - text: Delete connection string {connectionId} so no client can use it.
        slots:
          connectionId: path.connectionId
      method: generated
      generated: '2026-09-26'