# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Method Account Subscriptions API
  version: 1.0.0
extends: openapi/methodfi-account-subscriptions-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: 4
- target: $.paths['/accounts/{accountId}/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List subscriptions on an account
      effect: read
      questions:
      - Which recurring updates is this account subscribed to?
      - Can I see all active subscriptions on one account?
      instructions:
      - text: List subscriptions for account {account}.
        slots:
          account: path.accountId
      - text: Show what account {account} is enrolled in.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/subscriptions'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe an account to a product
      effect: write
      questions:
      - How do I enroll an account in a recurring subscription?
      - Can I subscribe one account to recurring updates?
      instructions:
      - text: Enroll account {account} in {enroll}.
        slots:
          account: path.accountId
          enroll: requestBody.enroll
      - text: Subscribe account {account} to {enroll} updates.
        slots:
          account: path.accountId
          enroll: requestBody.enroll
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/subscriptions/{subId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one account subscription
      effect: read
      questions:
      - Is a specific account subscription still active?
      - Can I fetch an account subscription by its ID?
      instructions:
      - text: Get subscription {subscription} on account {account}.
        slots:
          subscription: path.subId
          account: path.accountId
      - text: Check the status of subscription {subscription} for account {account}.
        slots:
          subscription: path.subId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/subscriptions/{subId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an account subscription
      effect: destructive
      questions:
      - How do I stop recurring updates on an account?
      - Can I unsubscribe an account from a product?
      instructions:
      - text: Delete subscription {subscription} on account {account}.
        slots:
          subscription: path.subId
          account: path.accountId
      - text: Unenroll account {account} from subscription {subscription}.
        slots:
          account: path.accountId
          subscription: path.subId
      method: generated
      generated: '2026-10-01'