API Evangelist conversational phrasing for Hilt So Memberships API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hilt So Memberships API
  version: 1.0.0
extends: openapi/hilt-so-memberships-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: 11
- target: $.paths['/v1/memberships'].get
  update:
    x-apievangelist-phrasing:
      intent: List memberships
      effect: read
      questions:
      - Which members currently have access to my products?
      - Can I filter memberships by status or platform?
      - How do I search my members by name or handle?
      instructions:
      - text: List memberships for product {product_id}.
        slots:
          product_id: query.product_id
      - text: Show {status} memberships on {platform}.
        slots:
          status: query.status
          platform: query.platform
      - text: Search memberships for {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/lookup'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up memberships by wallet or transaction
      effect: read
      questions:
      - Which membership belongs to this wallet address?
      - Can I find a membership from the transaction signature that paid for it?
      instructions:
      - text: Look up memberships for wallet {wallet}.
        slots:
          wallet: query.wallet
      - text: Find the membership paid by transaction {tx_signature}.
        slots:
          tx_signature: query.tx_signature
      - text: Look up memberships for identity {identity}.
        slots:
          identity: query.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/renewal-intelligence'].get
  update:
    x-apievangelist-phrasing:
      intent: Get renewal cohorts and reminders
      effect: read
      questions:
      - Which members are coming up for renewal soon?
      - What does my renewal reporting look like over the next few weeks?
      instructions:
      - text: Show members renewing within {window_days} days.
        slots:
          window_days: query.window_days
      - text: Give me the renewal intelligence report.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a membership
      effect: read
      questions:
      - What are the details of a specific membership?
      - When does this member's access expire?
      instructions:
      - text: Get membership {membership_id}.
        slots:
          membership_id: path.membership_id
      - text: Show expiry for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/notes'].patch
  update:
    x-apievangelist-phrasing:
      intent: Save notes on a membership
      effect: write
      questions:
      - Can I keep private merchant notes on a member?
      - Where do I record internal notes about a membership?
      instructions:
      - text: Save note {notes} on membership {membership_id}.
        slots:
          notes: requestBody.notes
          membership_id: path.membership_id
      - text: Update merchant notes for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/profile'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a member's display details
      effect: write
      questions:
      - Can I change how a member's platform name is displayed?
      - How do I correct a member's shown handle?
      instructions:
      - text: Set the platform display of membership {membership_id} to {platform_display}.
        slots:
          membership_id: path.membership_id
          platform_display: requestBody.platform_display
      - text: Update display details for member {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/gift'].post
  update:
    x-apievangelist-phrasing:
      intent: Gift extra access days to a member
      effect: write
      questions:
      - Can I give a member free extra days of access?
      - Is it possible to add a note when gifting a membership extension?
      instructions:
      - text: Gift {days} days to membership {membership_id}.
        slots:
          days: requestBody.days
          membership_id: path.membership_id
      - text: Extend member {membership_id} by {days} days with note {note}.
        slots:
          membership_id: path.membership_id
          days: requestBody.days
          note: requestBody.note
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/retry-delivery'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry access delivery for a member
      effect: write
      questions:
      - A member paid but never got into the group - can I retry delivery?
      - What do I do if a member's access delivery failed?
      instructions:
      - text: Retry access delivery for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      - text: Re-send access to member {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/delivery-diagnostics'].get
  update:
    x-apievangelist-phrasing:
      intent: Diagnose Telegram or Discord delivery for a member
      effect: read
      questions:
      - Why wasn't a member added to my Telegram or Discord?
      - Can I inspect the bot automation for one membership?
      instructions:
      - text: Diagnose delivery for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      - text: Show the Telegram or Discord automation state for member {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/delivery-support-ticket'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a support ticket for a delivery issue
      effect: write
      questions:
      - Can I escalate a member's delivery problem to Hilt support?
      - Will it reuse an existing ticket if one is already open for that member?
      instructions:
      - text: Open a delivery support ticket for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      - text: Escalate member {membership_id}'s delivery issue to support.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memberships/{membership_id}/reactivation'].get
  update:
    x-apievangelist-phrasing:
      intent: Get renewal and reactivation links for a member
      effect: read
      questions:
      - How do I get a link so a lapsed member can come back?
      - Where can I find a member's renewal link to send them?
      instructions:
      - text: Get reactivation links for membership {membership_id}.
        slots:
          membership_id: path.membership_id
      - text: Show the renewal link for member {membership_id}.
        slots:
          membership_id: path.membership_id
      method: generated
      generated: '2026-09-26'