# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Snowflake Managed Account API
  version: 1.0.0
extends: openapi/snowflake-managed-account-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/v2/managed-accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed reader accounts
      effect: read
      questions:
      - Which managed reader accounts have I created for data consumers?
      - Can I see the URLs and locators of my managed accounts?
      instructions:
      - text: List all managed accounts.
      - text: Show me the reader accounts I manage.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/managed-accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed reader account
      effect: write
      questions:
      - How do I create a reader account for a consumer who isn't a Snowflake customer?
      - What admin details must I supply when creating a managed account?
      instructions:
      - text: Create managed account {name} of type {account_type} with admin {admin_name} and password {admin_password}.
        slots:
          name: requestBody.name
          account_type: requestBody.account_type
          admin_name: requestBody.admin_name
          admin_password: requestBody.admin_password
      - text: Create {account_type} account {name} for admin {admin_name} using password {admin_password}, noting {comment}.
        slots:
          account_type: requestBody.account_type
          name: requestBody.name
          admin_name: requestBody.admin_name
          admin_password: requestBody.admin_password
          comment: requestBody.comment
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/managed-accounts/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed reader account
      effect: destructive
      questions:
      - What happens to the objects inside a reader account when I remove it?
      - Can I immediately cut off a consumer's managed account access?
      instructions:
      - text: Delete managed account {name} and everything in it.
        slots:
          name: path.name
      - text: Remove the reader account I named.
      method: generated
      generated: '2026-10-01'