# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Copilot API V1 Customer Buyer Persona API
  version: 1.0.0
extends: openapi/zoominfo-customer-buyer-persona-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: 6
- target: $.paths['/copilot/v1/customer-buyer-personas'].get
  update:
    x-apievangelist-phrasing:
      intent: List my buyer personas
      effect: read
      questions:
      - Which buyer personas have we configured for our sales team?
      - Can I see all the decision-maker profiles we target?
      instructions:
      - text: List our buyer personas.
      - text: Show every buyer persona configured for my company.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/copilot/v1/customer-buyer-personas'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update a buyer persona
      effect: write
      questions:
      - How do I add a new buyer persona for the people we sell to?
      - Can I change just a few fields on an existing buyer persona?
      instructions:
      - text: Create a buyer persona {persona}.
        slots:
          persona: requestBody.data
      - text: Update the buyer persona with these changes {persona}.
        slots:
          persona: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/copilot/v1/customer-buyer-personas/{buyerPersonaId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a buyer persona
      effect: read
      questions:
      - What titles and pain points are defined on one buyer persona?
      - Can I look up a single buyer persona by its ID?
      instructions:
      - text: Show buyer persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      - text: Get the details of persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/copilot/v1/customer-buyer-personas/{buyerPersonaId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a buyer persona
      effect: destructive
      questions:
      - Can I permanently delete a buyer persona instead of archiving it?
      - Is deleting a buyer persona a hard delete?
      instructions:
      - text: Permanently delete buyer persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      - text: Remove persona {buyerPersonaId} for good.
        slots:
          buyerPersonaId: path.buyerPersonaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/copilot/v1/customer-buyer-personas/{buyerPersonaId}/actions/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a buyer persona
      effect: write
      questions:
      - How do I hide a buyer persona but keep it for history?
      - Does archiving a persona remove it from list results?
      instructions:
      - text: Archive buyer persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      - text: Hide persona {buyerPersonaId} from the persona list without deleting it.
        slots:
          buyerPersonaId: path.buyerPersonaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/copilot/v1/customer-buyer-personas/{buyerPersonaId}/actions/unarchive'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an archived buyer persona
      effect: write
      questions:
      - Can I bring back a buyer persona I archived?
      - How do I make an archived persona usable again?
      instructions:
      - text: Unarchive buyer persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      - text: Restore archived persona {buyerPersonaId}.
        slots:
          buyerPersonaId: path.buyerPersonaId
      method: generated
      generated: '2026-09-26'