# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Taboola Backstage Audiences Combined Audiences API
  version: 1.0.0
extends: openapi/taboola-combined-audiences-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: 4
- target: $.paths['/{account_id}/combined_audiences'].get
  update:
    x-apievangelist-phrasing:
      intent: List combined audiences in an account
      effect: read
      questions:
      - What combined audiences have I built in my account?
      - Can I list all the audiences I made by combining other segments?
      instructions:
      - text: List all combined audiences in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show every combined audience defined for {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/combined_audiences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a combined audience
      effect: write
      questions:
      - How do I combine several audience segments into one new audience?
      - Can I build a new audience from a mix of my existing segments?
      instructions:
      - text: Create a new combined audience in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Build a combined audience for {account_id} from these segments.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/combined_audiences/{audience_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one combined audience
      effect: read
      questions:
      - How do I see which segments make up a particular combined audience?
      - Can I fetch one combined audience by its ID?
      instructions:
      - text: Get combined audience {audience_id} in account {account_id}.
        slots:
          audience_id: path.audience_id
          account_id: path.account_id
      - text: Show the definition of combined audience {audience_id}.
        slots:
          audience_id: path.audience_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/combined_audiences/{audience_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a combined audience
      effect: write
      questions:
      - How do I change the segments in a combined audience I already created?
      - Can I edit an existing combined audience instead of making a new one?
      instructions:
      - text: Update combined audience {audience_id} in account {account_id}.
        slots:
          audience_id: path.audience_id
          account_id: path.account_id
      - text: Change the segment rules of existing combined audience {audience_id}.
        slots:
          audience_id: path.audience_id
      method: generated
      generated: '2026-09-26'