# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Targeting API
  version: 1.0.0
extends: openapi/mediamath-targeting-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: 20
- target: $.paths['/target'].get
  update:
    x-apievangelist-phrasing:
      intent: List targets via the legacy endpoint
      effect: read
      questions:
      - Is there an older singular /target endpoint for listing targets in MediaMath?
      - Can I still page through targets using the legacy target list call?
      instructions:
      - text: List targets using the legacy /target endpoint.
      - text: Search targets matching {q} on the legacy /target list.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a target via the legacy endpoint
      effect: write
      questions:
      - Can I create a new target through the old singular /target path?
      - What fields does the legacy create-target call need besides a name?
      instructions:
      - text: Create a target named {name} using the legacy /target endpoint.
        slots:
          name: requestBody.name
      - text: Create a legacy-path target {name} under parent {parent_id}.
        slots:
          name: requestBody.name
          parent_id: requestBody.parent_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target/{target_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a target via the legacy endpoint
      effect: read
      questions:
      - How can I fetch one target by ID from the legacy /target path?
      - Does the legacy single-target lookup still return a target's details?
      instructions:
      - text: Get target {target_id} from the legacy /target endpoint.
        slots:
          target_id: path.target_id
      - text: Show legacy-path details for target {target_id}.
        slots:
          target_id: path.target_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target/{target_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a target via the legacy PUT endpoint
      effect: write
      questions:
      - Can I update a target with an HTTP PUT on the legacy /target path?
      - Which target fields can the legacy PUT update change, like name or dimension code?
      instructions:
      - text: Update target {target_id} with a PUT on the legacy /target path, renaming it to {name}.
        slots:
          target_id: path.target_id
          name: requestBody.name
      - text: Use the legacy PUT call to set target {target_id} visibility to {visible}.
        slots:
          target_id: path.target_id
          visible: requestBody.visible
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target/{target_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a target via the legacy POST endpoint
      effect: write
      questions:
      - Is there a POST-based legacy call to update a target on the singular /target path?
      - Do I need to pass the version when updating a target through the legacy POST?
      instructions:
      - text: Update target {target_id} with a POST on the legacy /target path, renaming it to {name}.
        slots:
          target_id: path.target_id
          name: requestBody.name
      - text: Using the legacy POST update, change target {target_id} bidder frequency to {bidder_frequency}.
        slots:
          target_id: path.target_id
          bidder_frequency: requestBody.bidder_frequency
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target/{target_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a target via the legacy endpoint
      effect: destructive
      questions:
      - Can I remove a target through the old singular /target delete call?
      - Is deleting a target on the legacy path permanent?
      instructions:
      - text: Delete target {target_id} using the legacy /target endpoint.
        slots:
          target_id: path.target_id
      - text: Remove target {target_id} through the legacy delete call.
        slots:
          target_id: path.target_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targets'].get
  update:
    x-apievangelist-phrasing:
      intent: List targets
      effect: read
      questions:
      - Which targets are available in my MediaMath account?
      - Can I sort and page through the current targets list?
      instructions:
      - text: List all targets.
      - text: List targets matching {q}, sorted by {sort_by}.
        slots:
          q: query.q
          sort_by: query.sort_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a target
      effect: write
      questions:
      - How do I add a new target value to the current targets collection?
      - What is required to create a target with a dimension code and IP range?
      instructions:
      - text: Create a target named {name}.
        slots:
          name: requestBody.name
      - text: Create target {name} with dimension code {dimension_code} and IP range {target_inet}.
        slots:
          name: requestBody.name
          dimension_code: requestBody.dimension_code
          target_inet: requestBody.target_inet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targets/{target_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a target
      effect: read
      questions:
      - What are the details of a single target on the current targets endpoint?
      - Can I look up one target's parent and dimension by its ID?
      instructions:
      - text: Get target {target_id}.
        slots:
          target_id: path.target_id
      - text: Show me the name and dimension of target {target_id}.
        slots:
          target_id: path.target_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targets/{target_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a target
      effect: write
      questions:
      - Can I rename an existing target or change its visibility?
      - What does updating a target on the current /targets endpoint require?
      instructions:
      - text: Rename target {target_id} to {name}.
        slots:
          target_id: path.target_id
          name: requestBody.name
      - text: Set the parent of target {target_id} to {parent_id}.
        slots:
          target_id: path.target_id
          parent_id: requestBody.parent_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targets/{target_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a target
      effect: destructive
      questions:
      - How do I delete a target I no longer need?
      - What happens when I delete a target from the current targets collection?
      instructions:
      - text: Delete target {target_id}.
        slots:
          target_id: path.target_id
      - text: Permanently remove target {target_id} from my targets.
        slots:
          target_id: path.target_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target-path'].get
  update:
    x-apievangelist-phrasing:
      intent: List target paths
      effect: read
      questions:
      - Where can I see the full hierarchy paths of targets?
      - Can I search target paths by name?
      instructions:
      - text: List target paths.
      - text: Find target paths matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targeting'].post
  update:
    x-apievangelist-phrasing:
      intent: Add and view targeting for a strategy
      effect: write
      questions:
      - How do I attach targeting to a strategy and see what it now targets?
      - Can I set a strategy's targeting and get the result back in one call?
      instructions:
      - text: Add targeting {targeting} to strategy {strategy_id}.
        slots:
          targeting: requestBody.targeting
          strategy_id: requestBody.strategy_id
      - text: Show the targeting for strategy {strategy_id}.
        slots:
          strategy_id: requestBody.strategy_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contextual_segments/cpm_estimate'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate CPM for contextual segments
      effect: read
      questions:
      - What CPM should I expect for a set of contextual segments?
      - Can I estimate contextual segment cost with some segments excluded?
      instructions:
      - text: Estimate the CPM in {currency_code} for contextual segments {include}.
        slots:
          currency_code: requestBody.currency_code
          include: requestBody.include
      - text: Estimate contextual CPM in {currency_code} including {include} and excluding {exclude}.
        slots:
          currency_code: requestBody.currency_code
          include: requestBody.include
          exclude: requestBody.exclude
      method: generated
      generated: '2026-10-01'
- target: $.paths['/targeting_segments/frequently_used'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an advertiser's most used contextual segments
      effect: read
      questions:
      - Which contextual segments does this advertiser use most often?
      - Can I get just the top few frequently used contextual segments?
      instructions:
      - text: Show the most frequently used contextual segments for advertiser {advertiser_id}.
        slots:
          advertiser_id: query.advertiser_id
      - text: Get the top {top} contextual segments used by advertiser {advertiser_id}.
        slots:
          top: query.top
          advertiser_id: query.advertiser_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audience_segments/frequently_used'].get
  update:
    x-apievangelist-phrasing:
      intent: Get most used audience segments
      effect: read
      questions:
      - Which audience segments are used most for an advertiser or campaign?
      - Can I see the top audience segments a specific campaign relies on?
      instructions:
      - text: Show the most frequently used audience segments for campaign {campaign_id}.
        slots:
          campaign_id: query.campaign_id
      - text: Get the top {top} audience segments for advertiser {advertiser_id}.
        slots:
          top: query.top
          advertiser_id: query.advertiser_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audience_segments/cpm_estimate'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate CPM for audience segments
      effect: read
      questions:
      - What would a set of audience segments cost per thousand impressions?
      - Can I get an audience segment CPM estimate in a specific currency?
      instructions:
      - text: Estimate the CPM in {currency_code} for audience segments {include}.
        slots:
          currency_code: requestBody.currency_code
          include: requestBody.include
      - text: Estimate audience CPM in {currency_code} including {include} but excluding {exclude}.
        slots:
          currency_code: requestBody.currency_code
          include: requestBody.include
          exclude: requestBody.exclude
      method: generated
      generated: '2026-10-01'
- target: $.paths['/technology_target_values'].get
  update:
    x-apievangelist-phrasing:
      intent: List technology target values
      effect: read
      questions:
      - Which technology targeting values exist for a dimension like browser or OS?
      - Can I search technology target values by name or full path?
      instructions:
      - text: List technology target values for dimension {dimension_code}.
        slots:
          dimension_code: query.dimension_code
      - text: Find technology target values named {name} in dimension {dimension_code}.
        slots:
          name: query.name
          dimension_code: query.dimension_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/path_targeting_segments'].get
  update:
    x-apievangelist-phrasing:
      intent: List contextual segments
      effect: read
      questions:
      - What contextual segments can I target?
      - Can I see contextual segment prices in my currency?
      instructions:
      - text: List contextual segments.
      - text: List contextual segments matching {q} with prices in {currency_code}.
        slots:
          q: query.q
          currency_code: query.currency_code
      method: generated
      generated: '2026-10-01'
- target: $.paths['/path_audience_segments'].get
  update:
    x-apievangelist-phrasing:
      intent: Search audience segments by path
      effect: read
      questions:
      - How do I search the audience segment tree for a segment by name?
      - Can I limit audience segment results to brain-enabled ones for an advertiser?
      instructions:
      - text: Search path audience segments for {q}.
        slots:
          q: query.q
      - text: Find audience segments matching {q} under parent {parent_id}.
        slots:
          q: query.q
          parent_id: query.parent_id
      - text: Search audience segments for {q} for advertiser {advertiser_id}, brain-enabled only {only_brain_enabled}.
        slots:
          q: query.q
          advertiser_id: query.advertiser_id
          only_brain_enabled: query.only_brain_enabled
      method: generated
      generated: '2026-10-01'