# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Segment Groups API
  version: 1.0.0
extends: openapi/mediamath-segment-groups-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: 6
- target: $.paths['/segment_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List segment groups
      effect: read
      questions:
      - Which segment groups exist in my organization?
      - Can I see segment group prices in a particular currency?
      instructions:
      - text: List segment groups.
      - text: Find segment groups matching {q} with prices in {currency_code}.
        slots:
          q: query.q
          currency_code: query.currency_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/segment_groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a segment group
      effect: write
      questions:
      - How do I bundle segments into a new segment group?
      - What fields are required to create a segment group?
      instructions:
      - text: Create segment group {name} of type {type} for organization {organization_id} with status {status} and subgroups {segment_subgroup}.
        slots:
          name: requestBody.name
          type: requestBody.type
          organization_id: requestBody.organization_id
          status: requestBody.status
          segment_subgroup: requestBody.segment_subgroup
      - text: Create segment group {name} in organization {organization_id}.
        slots:
          name: requestBody.name
          organization_id: requestBody.organization_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/segment_groups/{segment_group_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a segment group
      effect: read
      questions:
      - What segments make up a particular segment group?
      - Can I view a segment group's pricing in my currency?
      instructions:
      - text: Get segment group {segment_group_id}.
        slots:
          segment_group_id: path.segment_group_id
      - text: Show segment group {segment_group_id} with prices in {currency_code}.
        slots:
          segment_group_id: path.segment_group_id
          currency_code: query.currency_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/segment_groups/{segment_group_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a segment group
      effect: write
      questions:
      - Can I rename a segment group or change its subgroups?
      - Is it possible to deactivate an existing segment group?
      instructions:
      - text: Rename segment group {segment_group_id} to {name}.
        slots:
          segment_group_id: path.segment_group_id
          name: requestBody.name
      - text: Set segment group {segment_group_id} status to {status}.
        slots:
          segment_group_id: path.segment_group_id
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/segment_groups/{segment_group_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a segment group's change history
      effect: read
      questions:
      - Who modified this segment group?
      - Can I see past changes to a segment group?
      instructions:
      - text: Show the change history for segment group {segment_group_id}.
        slots:
          segment_group_id: path.segment_group_id
      - text: Get the audit log of segment group {segment_group_id}.
        slots:
          segment_group_id: path.segment_group_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/segment_groups/{segment_group_id}/assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List where a segment group is assigned
      effect: read
      questions:
      - Which strategies or entities use a given segment group?
      - Can I see every assignment of a segment group?
      instructions:
      - text: List assignments for segment group {segment_group_id}.
        slots:
          segment_group_id: path.segment_group_id
      - text: Show where segment group {segment_group_id} is being used.
        slots:
          segment_group_id: path.segment_group_id
      method: generated
      generated: '2026-10-01'