# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for LINE Messaging Manage Audience API
  version: 1.0.0
extends: openapi/line-manage-audience-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: 10
- target: $.paths['/v2/bot/audienceGroup/upload'].put
  update:
    x-apievangelist-phrasing:
      intent: Add user IDs to an existing audience via JSON
      effect: write
      questions:
      - How do I add more user IDs to an audience I already created, sending them as JSON?
      - Can I append IFAs to an existing upload audience without a file?
      instructions:
      - text: Add users {audiences} to existing audience {audienceGroupId}.
        slots:
          audiences: requestBody.audiences
          audienceGroupId: requestBody.audienceGroupId
      - text: Append these IDs {audiences} to audience {audienceGroupId} with upload note {uploadDescription}.
        slots:
          audiences: requestBody.audiences
          audienceGroupId: requestBody.audienceGroupId
          uploadDescription: requestBody.uploadDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/upload'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an audience from a JSON list of user IDs
      effect: write
      questions:
      - How do I create a new audience from a list of user IDs sent as JSON?
      - Can a new JSON-uploaded audience be built from advertising IDs?
      instructions:
      - text: Create a new audience named {description} with users {audiences}.
        slots:
          description: requestBody.description
          audiences: requestBody.audiences
      - text: Make a new IFA-based audience {description} from IDs {audiences}, isIfaAudience {isIfaAudience}.
        slots:
          description: requestBody.description
          audiences: requestBody.audiences
          isIfaAudience: requestBody.isIfaAudience
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/click'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a click-based retargeting audience
      effect: write
      questions:
      - Can I build an audience of users who clicked a link in a message I sent?
      - What do I need to create a click-based retargeting audience?
      instructions:
      - text: Create a click audience {description} from users who clicked {clickUrl} in message request {requestId}.
        slots:
          description: requestBody.description
          clickUrl: requestBody.clickUrl
          requestId: requestBody.requestId
      - text: Retarget everyone who clicked a link in broadcast {requestId}.
        slots:
          requestId: requestBody.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/imp'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an impression-based retargeting audience
      effect: write
      questions:
      - How can I target users who opened a message I sent?
      - Can I create an audience from impressions of one broadcast?
      instructions:
      - text: Create an impression audience {description} from message request {requestId}.
        slots:
          description: requestBody.description
          requestId: requestBody.requestId
      - text: Build a retargeting audience of users who viewed message {requestId}.
        slots:
          requestId: requestBody.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/{audienceGroupId}/updateDescription'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename an audience
      effect: write
      questions:
      - How do I rename an existing audience?
      - Can I change an audience's name after creating it?
      instructions:
      - text: Rename audience {audienceGroupId} to {description}.
        slots:
          audienceGroupId: path.audienceGroupId
          description: requestBody.description
      - text: Change the name of audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/{audienceGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one of my audiences
      effect: read
      questions:
      - What's the status and size of one of the audiences in my channel?
      - Can I look up an audience I own by its ID?
      instructions:
      - text: Get audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      - text: Show details for my own audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/{audienceGroupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an audience
      effect: destructive
      questions:
      - How do I delete an audience I no longer need?
      - Is deleting an audience by ID permanent?
      instructions:
      - text: Delete audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      - text: Remove audience {audienceGroupId} permanently.
        slots:
          audienceGroupId: path.audienceGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List and search my audiences
      effect: read
      questions:
      - Which audiences does my channel have, and can I filter them by status?
      - Can I search my audiences by a partial name match?
      - What's the maximum number of audiences returned per page?
      instructions:
      - text: List page {page} of my audiences.
        slots:
          page: query.page
      - text: Find my audiences whose name contains {description} with status {status}, page {page}.
        slots:
          description: query.description
          status: query.status
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/shared/{audienceGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Business Manager shared audience
      effect: read
      questions:
      - How do I look up an audience shared with me through Business Manager?
      - Can I see details of a shared audience by its ID?
      instructions:
      - text: Get shared audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      - text: Show the Business Manager shared audience {audienceGroupId}.
        slots:
          audienceGroupId: path.audienceGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/bot/audienceGroup/shared/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List audiences including Business Manager shares
      effect: read
      questions:
      - Which audiences have been shared with me through Business Manager?
      - Can I list shared audiences together with the ones I own?
      instructions:
      - text: List page {page} of audiences shared via Business Manager.
        slots:
          page: query.page
      - text: Get shared and owned audiences on page {page} with includesOwnedAudienceGroups {includesOwnedAudienceGroups}.
        slots:
          page: query.page
          includesOwnedAudienceGroups: query.includesOwnedAudienceGroups
      method: generated
      generated: '2026-09-26'